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/ DSTRECRDS =~ DEFINITION FILE FOR THE DEBUG SYMBOL TABLE 


: Version: *v04-000' 


(ppm: eeecebtapaneets- tani mere nipidewen ras ae 
‘* 

it COPYRIGHT (c) 1978, 1980, 1982, 1984 B 

ie DIGITAL EQUIPMENT CORPORATION, MAYNARD. MASSACHUSETTS. 
it ALL RIGHTS RESERVED. 


tt THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY BE USED AND soPtee 
:* ONLY IN ACCORDANCE WITH THE TERMS OF SUCH at NSE AND WITH THE 
't INCLUSION OF THE ABOVE See eriee NOTICE. THIS SOFTWARE OR ANY OTHER 

'* COPIES THEREOF sy NOT BE PROVIDED OR OTHERWISE MADE AVAILABLE TO ANY 
:. viensreaneee O TITLE TO AND OWNERSHIP OF THE SOFTWARE IS HEREBY 


ie THE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE WITHOUT NOTICE 
i: eepPORAT ibe NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL EQUIPMENT 


:* DIGITAL ASSUMES NO RESPONSIBILITY FOR THE USE OR 7 etal OF ITS 
:* SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DIGITAL 


e@eneneeneneeeneneneennnnnnnne 


i eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeneneeeeeeeneeeeeeeeeeeneeeeeeeeeeeeeeeee 


WRITTEN BY 
Bruce Olsen August, 1980. 
Bert Beander August, 1 
Bert Beander November, 7983. 


MODULE FUNCTION 
This REQUIRE file describes the structure of the Debug Symbol Table 
perereres by the VAX compilers and interpreted "t the VA Debugger. 
t includes definitions for all field names and Liecets used in 
building or interpreting the Debug fe. Table (DST). 


DISCLAINGR 

This interface is not queperted by Digital. While the Debug Symbol 
Table interface is bel d to be correctly described here, Digital 
does not guarantee that ee Copcr int ions , in sots definition file are 
correct and complete. Also le thi $ interface is expected to be 
reasonably stable across + vty Digital sonnet | uerantes that it 
will not change in future releases of VAW DEBUG X VAS, the VAX 
compilers, or other spr tuere. pward econee ble additions t to this 
interface are more Likely then | ncompat iD e shenees, pus in seerv duals 
and organizations who use this interface stand some r t their 
work will be partially or wholly invalidated by future Bn es of 
VAX DEBUG or other Digital software. Digital reserves the right to 


TBI 
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: make future incompatible changes to the Debug Symbol Table interface. 
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PURPOSE OF THE DEBUG SYMBOL TABLE 


The — Symbol Table (DST) is the synbol table that the VAX compilers 
roduce to pass syabol table information to the VAX Debugger and to the 
AX Traceback facility. The OST is a ponguage.incependen syayet table 

in the sense that all VAX compilers outpu syepet nformation in po 

same format, regardless of source language. This symbol information is 
emitted into the object modules produced by the compiler. It is then 
passed through the Linker into the executa Le snoop file that the Linker 
enerates EBUG or TRACEBACK can then retrieve the symbol information 
rom the image file. 

The pyrene of the Debug anor Table is thus to permit the srecevers 

facility to give a symbolic stack dump on abnormal program termination 

and to permit DEBUG to puppert fully oyane) ve debugging. Other Digital 
software may also use the DST information for various purposes. 


To support these purposes, the bobs Symbol Table represents all major 
aspects of program structure and data representation. It can represent 
modules, routines, lexical blocks, labels, and data symbols and it can 
represent eS nesting relationships between such symbols. It can also 
describe Line number and source Line information. It can describe all 
data types supported oY DEBUG, ihe complex types such as record 
structures and enumeration types. In addition, it can describe arbi- 
trarily complex value and address computations. 


The Debug Symbol Table is solely intended to suspert compiled Languages, 
not interpreted languages. The DST representation assumes that source 
Lines have been compiled into VAX instructions and that those instruc- 
tions are actual hy executed, not interpreted. Such DEBUG facilities as 
breakpoints and single-stepping will not work if this assumption is 
violated. Similarly, it is assumed that data objects have addresses 
that can be accessed directly when these objects are examined or depo- 
sited into. DST information is thus generated + all compilers that 
my DEBUG sypperts, but not by the interpreters for Languages such as 
or MUMPS, 
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GENERAL STRUCTURE OF THE DST 


t explains how the DST is generated by the yer tous VAX roapiters. how 
t is passed along to the executable nage file the Linker, and how 
it is eccoapes in the image file by DEBUG or TRACEBACK. This section 
also describes in general terms how the DST is structured internally: 
how it is subdivided ate modules, routines, lexical blocks, and indi- 
vidual symbols, how nesting relationships are represented, and how data 
symbols, ore their values and data types. are represented. e 
exact formats of the various Debug symbol able records and other fine- 
rained detail are described later in this definition file, not here, 
ut the coarse structure of the DST and how that structure is accessed 
are outlined in this section. 


GENERATION OF THE DST 


The Debug Symbol Table (DST) is generated by the ilers for all VAX 
Languages Supported by DEBUG. During compilation, the compiler outputs 
the DST for the module being compiled into the perreepena object 
file. When the Linker is invoked, it does relocation and global-symbol 
resolution on the DST text and then outputs it into the executable image 
ile. Beyond knowing what must be relocated, the Linker has no specia 
unous edge of the format or contents of the DST. Finally, the Debugosr 
reads the DST information from the executable image file during a debug- 


This 4p hey describes the general structure of the Debug Symbol Table. 


ing session, or Traceback reads it when giving a traceback in response 


© an unhandled severe exception during image execution. 


A compiler outputs DST information in the form of two kinds of object 
records, TBT records and DBT records. (See the Linker manual for a 

full description of the VAX object language accepted by the linker.) |. 

ALL “‘traceback"’ information goes into the TBT records and all ‘symbol 

information goes into the DBT records. When the user later Links using 

the plain LINK command, only the DST information in the TBT records are 

copied to the executable image file. These records contain enough in- 

formation for Traceback to give a call-stack traceback. If the user 

Links with the LINK/DEBUG command, all information in both the TBT and 

the DBT records are copied to the executable image file. These records 

together give ptt ost nformation needed for ful pyabotic debugging. 

The user can also Link with LINK/NOTRACEBACK, in which case no DST in- 
formation at all is copied to the executable image file. 


It is not possible to have the Linker copy the DBT records without also 
copying the TBT records; the information in the TBT records is requi ‘ed 
for the information in the DBT records to make sense. 


n and End DST records, all Lexical 
all Line Number PC-Correlation DST 


The ‘‘traceback’’ information in the wr records includes all Module Begin 
nd q 

records. It ney o}80 include Version Number DST records. All other DST 
e 


H 
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Most VAX compilers hove a /DEBUG qualifier which in its most generat 
form has two subqual gr: /DEBUG=(LNOJTRACEBACK ,CNOJSYMBOLS). The 
unadorned /DEBUG qualit er is equivalent to /DEBUG=(TRACEBACK, SYMBOLS); 
it causes all DST in raat ten te be output. /DEBUG=TRACEBACK causes 
only the traceback information (the TBT records) to be outoys by the 
compiler. /DEBUG=(NOTRACE ,NOSYMBOL) causes no DST information to be 
output at all. by LE /6EBUG= (NOTRACE , SYMBOLS) causes all DST infor- 
mation excepy Line Number PC-Correlation DST records to be output (this 
combination is largely pointless gt though t saves some 4h space). 
Note that the module cout tae and lexical block information, which 

% as sreceseck informat on, must be output if any symbol informa- 
t -, i since it defines the scopes within which other symbols 
are defined. 


When the Linker outputs the Debug Symbol Table to the executable image 
file, it may also output two more image sections: the Global Symbol 
Table (GST) and the Debug Module Table (DMT). These two tables are 
enerated if the LINK/DEBUG command is used, not otherwise. The Global 
ymbol Table contains records for all global symbols known to the Linker 
in the current user program. DEBUG uses the GST as ? symbol table of 
last resort when DST information is not available, either because the 
module containing some global symbol was compiled without DST informa- 
tion being out or because the module is not set (with SET MODULE) in 
the current debugging session. The GST information is not as complete 
as me DST information for the same symbols because the GST has no type 
description (the Linker does not need to know about data types). 


The Debug Module Table (DMT) is an indexing structure for the DST. It 
contains one record for each module in the DST. This record contains 

&@ pointer to the start of the DST for the corresponding module, the size 
of the DST for that module, the number of PSECTs in that module, and the 
address ranges of all those PSECTs. The DMT allows DEBUG to initialize 
its Module Table and its Static Address Table without actually Bev ing to 
read through the entire DST; because the DMT is very small compared to 
the DST, it can be scanned much more efficiently. 


The details of how the DST, the GST, and the DMT are accessed in the 
executable image file are explained in the next section. 


' 
i 
L 
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long 
long 
Long 
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LOCATION OF THE DST WITHIN THE IMAGE FILE 


The Debug Syqbo} Table is pecesees chrougp »veratec information found in 
the executable image bs header block der block contains a 
ointer in a fixed pocet on CInDSY_ SfMOBGOFF) which points to a paolt 
lock Later in the header wnich gives the size and Locet on of the 
penup syapel Table (DST), the Global Symbol Table (GST), and the Debug 
e Table (DMT). The first part of the executable image file header 
looks as follows: 


' ' 
terre ome nee oe meme mooceme mene nw eco r fe or wee ee owe ete mae wmm aman cce weer a + 


' 
' 
' 
' 
\ 
See ee eee eeeeo rene seem eee See eeeeeeeeeeeoeeooee Sen ese etree seo } 


Here IHD$W_SYMDBGOFF contains the ty | offset relative to the start of 
the header of an Image Header Symbol Table poogr peter - The Image Header 
Symbol Table Descriptor (IHS) in turn has the following format: 


$e ecer ems SEEKS Hee Ee wee een awe Seem ere ee rov wate nce neem ee oe Se oe + 


' __JHSSL -DSTVBN ' 
H ~THSSL _SSTVEN ' 


doe meeen ne weeccescoescooosoeeeoos$} eee weno meee SoBe Ee oe + 


' __THSSW_ GSTRECS i IHS$W_DSTBLKS 
i IHS$L -DMTVBN ' 


geome ace see eee ese ee nw ewer eee recor eo ees wWeweer eer ee ween ance oersenee Sa 


‘ IHSSL_DMTBYTES ' 


gow oer eS Se eee eee e2eeee2 SPSS SSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSESESESESEEeS + 


Here IHS$W_DSTBLKS and IHS$L ahStyen give phe size (in blocks) and loca- 
tion (VirtGal Block Number) Of the bebud syebes Table (DST) within the 
executable image file. The fields as A pa Tage and IHS$L_GSTVBN give 
he size ( tual Block Number 


tT) of the Debug Module Table (DMT The DAT is described below. 
These Heuneens ote ae clared by macros in SYSSLIBRARY : (ie 3 2. The 
symbol IHD$W_SYMDBGOFF 1s also defined in SYSSLIBRARY:LIB.L3 


Pointers to the Image Header and the Image Header Symbol Table Descrip- 
tor are declared as follows: 


' 
i 
' 
' 
' 
' 
' 
i 
L 
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IHDPTR: REF BLOCKE BYTE) 
IHSPTR: REF BLOCKCEHSSK_LENGTH,BYTE) 


hae sae e File Header in e executable {pe e file points. f°, ™ ¢ inepe 
erg? Table descriptor as describe Mga} d 
Nos. LN Anya in che ms header is tet 5 ," Apis . nage, 
Fodu ced b y the 0 or Later Th and the 1HSS _DM and 
THs DMTIBYTES f ~ Py exist “ tha, of anee Header Symbol Table BIVON ond 
(If bit 5 is not set, this is mage and those fields do not 
exist.) If non-zero, IHSS$L -bat Van ves the Virtual Tngée Number in 
the image file of the Debug rere able (the oats SSL_DMTB ovyes 
then gives the size of bytes. The D nly but lt if the 
user did a LINK/DEBUG; " x. did not, IHSS$L NSMTVEN ona IHSSL ‘DATBYTES' 
are zero. 


The Debug Module Table sep seine one entry per module in the Debug 
Symbol Table (the DST). This is the format of each such DMT entry: 


Sewer ee eee eee eee eee eee ee eeeeeeeeseSeeeeeseeoeeeesooooacooooanes + 


i tong } DST address of Module Begin DST Record 


tonewe See eee ee2 eee SSS SS SS SSSS SS SSS eee eanencana Se eeeoeeoaoaeae + 


i tong } Size in bytes of module's DST 


' 
' 
deere newman seer ceennce eeeeeooeoeece}oecoeen ee o¢ 
' 
' 
' 
' 


i Long i Unused--Must Be Zero {__Number of PSECTs for module 


brewer eee mh eee eee ee + 


(Two Longwords per PSECT) 


Se eee eee eee2eeeeee were rtewrr2er newer eer oe ewe ew me eMe ew me eerorereerec=— See eee eeeeeaee + 


Start address of last PSECT in module H 


oeeeoe eeerrerewrnrnwrrerrccrcererrerrwrreo ewe wmeo ert etm wee wmwmoeorwmrwreore. wm mererereereoeza= = + 


Length of Last PSECT in module in bytes H 


Pe eceen seem es eee eee ee ewe eee ene e ose wr eee eas wre wre wene oe 


oe } oe come wocece 


Longword 0 gives the address feletive to the eters f the DST of the 

Module Begin DST Record for this module. Longword gives the size 

of the DST in bytes for the same module. Long guord ¢ 9! ves the number 

of PSECTS in the module (i.e., the number of statically allocated 
program sections), and this is followed by thes shupeer of puentenquers 

perre mien give the start address and Length ( be o8ks th of each such 

Since the number of PSECTs cannot exceed the upper two 
bytes of longword 2 are available for future expansion. 


The DMT is used orice beeys initialization to initialize DEBUG's Run- 
Time Symbol T (RST) and Program Static Address Table ceregren, SAT). 
Using he DAT” $s much voster than the alternative procequre. namel y 

reading through the entire DST to pick up the needed information. The 
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for 
he 

€ 
ly 


information in the DMT -—_y is enough to build a Module RST Entr 
each module in the DST and the PSECT information is used to build 
Program SAT. The amount of RST symbol table space needed per mod 
not computable from the DMT information, but is estimated by mult 
the DST size of each module by an appropriate scale factor. 


-ce “«< 
Ur 


s 
ng 


OVERALL STRUCTURE OF THE DST 


The Debug Symbol Table consists of a contiguous sequence of DST records. 
Each DST record contains a two-byte header which gives the lenge’ of the 
record in bytes and the type of the record. The structure of the rest 
of the record (if any) is determined by the record type. The yength of 
the DST in 512-byte blocks is aivee in the image file header; if the DST 
does not fill the Last block, that block is zero-padded to the end. 


The largest structural unit within the DST is the module. Each module 
represents the symbol table information of a Feperesesy compiled object 
module. The DST for a module always begins with a Module Begin DST rec- 
ord and ends with a Module End DST record. The Module Begin DST record 
gives the name of the module and the source language in which it was 
written. The Module End DST record simply marks the end of the module 
and contains no other information. As noted above, if present, the 
— Module Table (DMT) points to the Module Begin DST record of each 
module represented in the DST. DEBUG uses the DAT (if present) to lo- 
cate all modules in the DST. 


The DST as a whole thus always begins with the Module Begin DST record 
for the first module in the DST. It is followed by the symbol informa- 
tion for that module. Then comes the Module End DST record for that 
module. Immediately after that Module End DST record comes the Module 
Begin DST record for the next module, and so on to the end of the whole 
DST, where the Module End DST record for the last module is found. The 
rest of that image file block is zero-filled to the next block boundary. 
Note that there is no break between modules in the DST. 


NESTING WITHIN THE DST 


For most languages, fhe symbol table must represent a variety ef nesting 
relationships. Routines are nested within modules, data sym ols are 
declared within routines, and even routines are nested within routines. 
Certain data constructs, in particular record structures, contain addi- 
tional nesting relationships. In | Debug syasot Table, such nesting 
relationships are represented by Begin-End pairs of DST records. We 
have already seen above that the largest subunit of the DST, namely the 

ule, is represented by a Module Beg n DST record and a Module End DST 
record bracketting the DST information for the module. 


This principle extends to other nesting relationships. The DST informa- 
tion for a routine is thus represented by a Routine Begin DST record and 
a Routine End DST record enclosing the DST information for all symbols 
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local to or nested within that routine. Similarly, lexical blocks (such 
as BEGIN-END blocks or their equivalents in various languages) are re- 
presences by Block Begin and Block End DST records enclos me he symbol 


T records local to that lexical block. ihe nesting of rou 
hin reason) is represented by 
Begin and End DST records. 


blocks within one another to any depen (wit 
the proper nesting of the corresponding 


nes and 


An example Soy Sele clarify this notion. The following example shows a 


program in a 
records: 


MODULE M = 
EGIN 


B 
VAR SYM_M1: INTEGER; 
VAR SYM_M2: REAL; 


ROUTINE R1 = 
BEGIN 


G1 
VAR SYM_R11: BOOLEAN; 
VAR SYM-R12: INTEGER; 


ROUTINE R2 = 
BEGIN 
VAR SYM_R21: DOUBLE; 

VAR SYM~Re2: INTEGER; 
ROUTINE R2A = 
BEGIN 
VAR SYM_R2A: BYTE; 
BEGIN 
VAR BLK_V1: WORD; 
ROUTINE R2BLKR = 
BEGIN 
FOO:BEGIN 
VAR FOO_V:REAL; 
END; 


VAR R2BLK_V2:REAL; 
END; 


VAR BLK_V2: DOUBLE; 
END; 


END; 
VAR SYM_R23: REAL; 
END; 


ctitious language along the corresponding sequence of DST 


Module Begin M 


Data SYM_M1 (DTYPE_L) 
Data SYM_M2 (DTYPE_F) 


Routine Begin R1 


Data SYM_R11 (BOOLEAN) 
Data SYM_R12 (DTYPE_L) 
Routine End (for R1) 


Routine Begin R2 


Data SYM_R21 (DTYPE_D) 
Data SYM_R22 (DTYPE_L) 
Routine Begin R2A 


Data SYM_R2A (DTYPE_B) 
Block Begin (no name) 
Data BLK_V1 (DTYPE Ww) 
Routine Begin R2BLRR 


Block Begin FOO 
Data FOO_V (DTYPE_F) 
Block End (for F006) 


Data R2BLK_V2 (DTYPE_F) 
Routine End (for R2BCKR) 


Data BLK_V2_ (DTYPE_D) 
Block End (for no fame) 


Routine End (for R2A) 


Data SYM_R23 serves F) 
Routine End (for R2y 


Module End 


Here module (compilation unit) M contains two module-level data items, 


' 
i 
' 
F 


4 
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SYM_M1 and SYM rn. and two routines. R1 gnd Re Routine R2 i 
tains several Togal cate symbols (SYM R21, SYM_ “R22, and SYM_R 
nested routine R nh turn contains an anonymous BEGIA- 
that blocks contains +e Local data symbols BLK_V1 and BLK_V2 
Local routine R2BLKR Coc es ag +3 My R2BLKR contains a data sy 7 and a 
Labelled PFs GIN-END block FOO, and block FOO contains one local symbol 
ALL this Biase is Seorseaen “ I. ane End DST records in 
the” Debug Symbol Table as illustrated on the Ss 


Additional nesting must be re ag yee for phi A record (called a 
structure in some Languages) omposite data object containing sone 
n ae of record components of f var ous data types. A record component 
may itself be a record. ate addition ed Languages allow records to 
have ‘‘variants’’ (as in PASCAL), which 

must be represented in the DST. 


A record type is rpergegnted by a Record Begin and Record End DST record 
pair ph eet bby | the DST records for the record components. This notion 
is illustrated by this program segment and the corresponding DST: 


n 
2 
E 
m 


mposes additional structure that 


Program Structure DST Record _Sequence 


TYPE RECTYP = Record Begin (RECTYP) 
RECORD OF 
COMP1: INTEGER; Data COMP! (DTYPE_L) 
prea? REAL; Data COMP (DTYPE- F) 
COMPS: DOUBLE; Data COMPS (DTYPE-D) 
END; Record End (for RECTYP) 


Here RECTYP is a record ig 2 coe? : ject | 1. pie type is a record con- 
taining three components. it etrugtere is 
represented in the D re s hesied penta’ Dsr’ anie followed by Data DST 
records for the conpanent s followed oe a Record End DST record. The 
addresses specified in the component DST records are bit or byte offsets 
from the start of the RECTYP record as a whole. 


In this example, the Record Begin DST reper Sor nechye ‘? in fact re- 
resent either a record type or a record object jield in the pecerd 
egin DST record indicates which. However, Let u ghtnn that RECTYP 

defines a record ty Bir How do we then declare objects of that type? 

The following ex e illustrates how: 


Program Structure 


DST Record Sequence 


Data REC1 {Sept ypspec c) 


TYPE RECTYP = Record Begin (R 
RECORD OF 
COMP1: INTEGER; Data COMP! (DTYPE_L) 
Sed REAL; Data Fone (DTVPE fF) 
COMPS: DOUBLE; Data (DTYPE"D) 
END; eh Ofnd (for RECTYP) 


TBK 


me me ee ee ee eee ee et et et Emm mmm mm 


N 
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VAR REC1: RECTYP; 
VAR REC2: RECTYP; Data REC2 (SepTypSpec) 
Type spec DST record 
(Indirect Typ 


e ath 
pointing to RECTYP) 


Here the same record type REC 
are also defined, REC1 and RE 


ollowed by a DST tycere that defines fhe symbol's ae type. 

catio s immed etely ollowed 
P Record Begin DST record: aqnee REC! is of che RECTYP data 
type. The REC2 Seperate ype Specificat m 


P is defined. Two objects of that aby 
y 


Records may be nested in the sense that a record component may itself be 
an object of some record type. A record component of a record type is 
represented the same way as any other object of a record type, namely by 
a Separate Type Specification DST record. This record must be followed 
by a Record Begin DST record or by a "yee Specification DST record that 
points to a Record Begin DST record. e record component can also be 
represented by a Record Begin DST record directly if this record is 
marked as defining an object rather than a type. 


Record variants, as found in PASCAL, introduce additional structure. A 
detailed description of how variants are represented in the DST is found 
in the section on ‘Record Structure DST Records’’ Later in this defini- 
tion file. Here we will only give an example that illustrates the gene- 
ral scheme that is used: 


Program Structure DST Record Sequence 
Data REC1 {Sept ypseec) 
TYPE RECTYP = Record Begin (RECTYP) 
RECORD OF 
COMP1: INTEGER; Data COMP! (DTYPE_L) 
CASE TAG: BOOLEAN OF Data TAG (BOOLEAN 
Variant Set Begin 
(tag variable = TAG) 
FALSE: (¢ Variant Value for FALSE 
Frees REAL; Data COMP2 (DTYPE_F) 
COMPS: DOUBLE); Data COMPS (DTYPE_D) 
TRUE: ( Variant Value for TRUE 
COMP4: INTEGER); Data COMP4 (DTYPE_L) 
END CASE; Variant Set End 


END; Record End (for RECTYP) 


TBK 


oe 
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VAR REC1: RECTYP; 


Nesting is also used to describe enumeration types as found in PASCAL 
and some other Lenguages. An enumeration type is described by an Enum- 
eration Type Begin DST record followed by Enumeration Type Element DST 
records for all the enumeration Literals of the type followed by an 
Enumeration Type End DST record. Any actual ob ec gt the enumeration 
tyge must be described by a Separate Type Specification DST record. 
re example illustrates what the DST for an enumeration type Looks 

e: 


Program Structure DST Record Sequence 
Data HUE (sept yospec? 
TYPE COLOR = ( Enum Type Begin COLOR 
Enum Type Element RED 
GREEN, Enum Type Element GREEN 
BLUE Enum Type Element BLUE 
ig Enum Type End (COLOR) 
VAR HUE: COLOR; 
VAR PAINT: COLOR; Data PAINT (SepTypSpec) 


pe Spec DST recor 
(Indirect Type Ppec 
pointing to COLOR) 


A more detailed description is found in the section entitled ‘‘Enumera- 
tion Type DST Records’ Later in this definition file. 


For some DST record types, DEBUG ignores all nesting relationships below 
the module level. Line Number PC-Correlation DST records, for example, 
mex be scattered throughout the DST for a module. DEBUG treats all such 
DST records as defining the Line number information for the module as a 
whole, regardless of how they may be scattered within or outside the 
routines and blocks of the module. eiateer ly Source File Correlation 
DST records may be scattered throughout the §1 for a module. Records 
such as these can be generates wherever the compiler finds it most con- 
venient to generate them. 


DATA REPRESENTATION IN THE DST 


Data Symbols are described in the DST by a variety of representations. 
Fundamentally, all such representations give three pieces of information 
about each data symbol: its name, its address or value, and its data 
type. DEBUG needs additional information about a data symbol, in parti- 
cular its scope of declaration, but that information is implicit in the 
nesting structure of the DST as described above. 


The name is given by a Counted ASCII string in the data symbol's DST 
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record. The value or address can be given by a five-byte encoding con- 
taining one byte of control information and a longword address, offset, 
or value. However, if this five-byte encoding is not adequate to de- 

3 He | the address or value, escapes to a more complex value specifica- 
tion Later in the DST record are available. The data type Sey be repre- 
sented by a one-byte type code, but if that is not adequate there are 
several escapes to a more complex type description elsewhere in the DST. 


The standard five-byte value specification can specify any 32-bit or 
smaller Literal value, “~~ static byte address, any register address, 
and any address that can be formed i one indexing operation off a reg- 
ister or one indirection or both. If a VAX Standard Descriptor exists 
for the symbol in user memory, the five-byte eerie can describe the 
descriptor address by any of the above means; the actual data address is 
then retrieved from the descriptor. 


The standard five-byte value specification is adequate for the bulk of 
all data symbols. However, there are cases_when it is inadequate. It 
cannot describe Literal values longer than 32 bits, it cannot describe 
very complex address computations, and it cannot describe bit addresses 
unless an appropriate descriptor fs available in user memory. For these 
cases, the first byte of the five-byte encoding must have one of several 
special escape values. The remaining longword then contains (in most 
cases) a pointer to a more complex value specification later in the same 
DST record. That more complex value popes (seat ieg may consist of a VAX 
Standard Descriptor or a ‘VS-Follows’’ Value Specification. A VS-Follows 
Value Specification can, in the most complex case, contain a routine to 
be executed by DEBUG to compute the desired value or address. This rou- 
tine may even call compiler-generated thunks when the complexity of the 
address computation so requires. 


The details of these more complex value specifications are given in the 
section entitled ‘DST Value Specifications’ later in this definition 
file. The point being made here is simply that the DST provides a 
simple and compact value specification mechanism that is adequate for 
all simple cases, but it also provides several eocapes to arbitrarily 
complex DST Value Specifications. These complex value specifications 
are capable of describing all known address and value computations 
required by the languages supported by DEBUG. 


Data type specifications are done in a similar wey For all simple, 
atomic data types, a single type byte describes the data type of a data 
symbol. However, there are several escape mechanisms for more complex 
data types. One mechanism is to take the type information from a VAX 
Standard Descriptor found either in user memory or in the DST. Another 
is to use a Separate Type Specification DST record for the data symbol. 
The data type is then Seece beg by a second DST record which immediately 
follows the Separate Type Specification DST record. This second record 
must be a Record Begin DST record cgpece 1b ing a record type), an Enume- 
ration Type Bogie DST record (descr bing an qouneret ion ypes, or a Type 
Specification DST record. A type Specification DST record can describe 
any data type supported oY DEBUG. It contains a DST Type Speci teat ion 
for the data typ in question. This Type Specification may be an Indi- 
rect Type Specification, pointing to ; ST recere elsewhere in the DST 
that defines the data type. Alternatively, it may describe the desired 
data type directly and may be as complex as the data type requires. 
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DST Type Specifications are described in a separation section elsewhere 
in this definition file. The gotng betes made here is finely that the 
simple one-byte type specification is available for simple data types, 
but several ae ay to arbitrarily s9ne lex DST ee specifications are 


available when the simple type specification is inadequate. 


' 
i 
i 
' 
' 
' 
' 
' 
' 
i 
i 
i 
L 
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FIELD ACCESS MACROS 


The following macros are used in defining BLISS field names for all data 
structures in the Debug Symbol Table. These macros supply the position, 
size, one sign-extension values when used in FIELD decterat ons for 


BLOCK and BLOCKVECTOR data structures. They are used instead of their 
numeric equivalents because they are clearer and less error-prone. The 
various generic forms (as specified by the letters in the names) are as 
follows: 

A Materialized address 

L Longword 

) Zero-extended word 

8 Zero-extended pyte 

V Zero-extended bit field 

SW Sign-extended word 

$8 Sign-extended pyte 

SV Sign-extended bit field 


The "'A’’ form should be used whenever the field being defined is such 
that only the address of the field may be materialized in a structure 
reference; that is, fetch and store operations on the field are not 
valid. An example of such a field is an ASCII string. 


Each of the ‘'V'’ and ‘'Sv'’ forms take one or two parameters. The first 
parameter is the bit position within the penguare or byte and the 
second is the field size in bits. The second parameter is optrangt: 

if omitted, it defaults to 1. Thus V_(5) means bit 5 while V_(5,3) 

means the $-bit field starting at bit 5 and ending at bit 7. Bit 

poets sens are counted from the low-order (least significant) end of the 
ongword, starting at zero. 


This fol leying field access macros are used in DSTRECRDS.REQ. Their 
actual definitions are found in STRUCDEF.REQ, but are shown here for 
the convenience of the reader. 


MACRO 

AL = 0, g. %, ' address of a field 

. 8, Be, i, ' Longword 

we = Q, 16, i, ' Word, zero-extended 

BL . 8, 8, x ' 8 te, zero-extended 

Vi(P,S) = P, RIF RNULL(S) XTHEN | ELSE § HFT. 0 2. | Unsigned 
! e 

Sw_ = 0, 16, 12, ! Word, sign-extended 

SB_ = Q, 8, : Byte gignrex tended 

SV~(P,S)= P, RIF ZNULL(S) XTHEN 7 ZELSE : FI, 1%, ! Signed 
! bit field 


Bring in the field access macro definitions from STRUCDEF.L32. 
IBRARY *LIBS:STRUCDEF .L32'; 


F 
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ee ee 


byte 
byte 


var 


THE DST RECORD HEADER FORMAT 


ALL DST records have the same general format gone *et toe of a fixed 
two-byte header followed by zero or more fields whose format is 
determined by the DST record's type. This is the format of all DST 


records: 

See ee rrrr®€, we weeewoeoeeenonoone eee + 
H DST$B LENGTH H 
: DSTSB_ TYPE H 
$ eee wme www wwe ww meme ee wwe eeeeoowscwecoecc= meee ewoeeeeeooesceece -+ 
i DSTSA_ “NEXT 
Zero or more additional fields depending on 
the value of the DSTSB_TYPE field 
Semen eeqneeueseeneensenepees anapusre pueEsanesenee weeneErEene + 


These fields appear in all DST records. 


FIELD DSTSHEADER FIELDS = 


DST$B_LENGTH =({ 0, B&B], ! The lgngr of this DST record, not 
: includ ing se yangt) byte 
DSTSB_TYPE = f 1. 8. : ! The type of this record 
DSTSA_NEXT =(€ 1, AL ! The next DST Bey starts at this 
- ; Location plus DST$B_LENGTH 
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SUPPORTED VALUES FOR DSTSB_TYPE 


ALL supported values of the DST record type field (DST$B_TYPE) are 
listed here. If the yelue is in the range of DSCSK_DTYPE_LOWEST to 
DSCSK_DTYPE_HIGHEST, it is a VAX Standar "yp¢ Code-and gives the 
data type of the object being defined, In s case, the record is 
a Standard Data DST Record or one of its variants. Otherwise, es 
type value must be in the range DSTSK_LOWEST to DSTSK_HIGHEST or it 
may be DSTSK_BLI. In these cases, thé type code denofes the type of 
the DST record and the format of the record is determined by type 
value. ALL other type codes are yngupported by DEBUG. The type codes 
between DSCSK_DTYPE_HIGHEST and DSTSK_LOWEST ors renetves for future 
use by Digital. Thé type codes in thé range 192 - 255 are potentially 
reserved for use 7 customers, although DEBUG does not support any 
pues type codes. DEBUG ignores all records with unsupported type 

C 


VAX STANDARD TYPE CODES 


As mentioned above, VAX Standard Type Codes can be used as DST record 
type codes for data symbols. The type code then giyes the data sree 
of the symbol in addition to indicating that the DST record has the 
Standard Data DST record format or a variant thereof. 


ALL VAX Gtenderd Type Codes are Listed here for convenience. They are 
commented out since they are actually declared in STARLET.REQ. 


ITERAL 


' 
i 
i 
i 
i 
i 
i 
L 


sages tr ted (May not appear in DST). 


oan 


RRRKKAKAAKRRRAKRALAAA 


“vnn 


' 

' 

! Byte logical. 

! Word logical. 

' Longword logical. 
' Quadword logical. 
! Byte integer. 

! Word integer. 

' Longword integer. 
! Quadword integer. 
: Single-precision floating. 
i 

i 

i 

i 

i 

i 

i 

i 


a a a at at tt tt ot ot ot 


Lt 


a 
‘ee 
ore 


Double-precision floating. 


mr dpa 

Dou so~erecteten Complex. 

ASCII text string. 

Numeric string, unsigned. 

Numeric string, left separate sign. 
Numeric string, Loft overpunched sign. 
Numeric string, right separate sign. 
Numeric string, right oyerpunched sign 
Numeric string, zoned s 


zZzzzz-97°" 


Re ee OD VNOU EWI" O 


COCO WY Or 2s es ee ee ees 


se © ese 8s 8 8&8 &© & & & 


ONKHNKWNKHKHKHNNHNONVNNNYNYHM 
PAOOOOOOOOOOOOOOOOOO 


MAMMA MRAM MT 


z 
fon) 
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i The next two values are used for range checking of the type values 
in DST entries. They are used mainly in CASE statements. 


! DSCSK_DTYPE_P = 21, ! Packed decimal string. 
i OSC$K ~prvee tl = 22, ! Sequence of instructions. 
i DSCSK“DTYPE-ZEM = 25, ! Procedure entry mask. 
DSCSK_DTYPE_DSC = 24, Descr b teat vatri for arrays of 
; ¢ strings 
i DSC$K_DTYPE_OU Ci, 7} mieestd ogical ° 
i DSCSK“DTYPE-O 2 g. ' Octaword nfeger 
i DSCSK_DTYPE_G = 27,  ! Double precision G floating, 64 4 bit 
i DSCSK =DIVPE WH = 8. ' Quadruple pre ision floating, 128 bit 
i DSCaK DIVE €_GC = 29,  ! Double precis *s complex 6 floatin 
i DSCSK-DTYPE_HC = 30, | Quadr e precision Feasler, A floa 
i DSCSK_DTYPE_CIT = 31, ! COBOL intermediate temporary 
i DSCSK-DTYPE_BPV = ¢° ! Bound Procedure Value 
i OSC$K a ible MO = 35, ! Bound La % Value 
i DSCSK-DTYPE_VU = 34, ! Bit Unal 
i DSCSK> “DTYPE_ADT = 35, ! Absolute ate-Tine 
i 5 g. ! Unused spot supported by DEBUG) 
} DSCSK_DTYPE_vT = 3, ! Varying Text 
! 
! 
' 
i 
D 
D 


SCSK_DTYPE_LOWEST = 1 ' Lowest DTYPE data type we support 
SCSK_DTYPE_HIGHEST = 3; ! Highest DTYPE data type we support 


INTERNAL TYPE CODES FOR DEBUG 


The following Sot talttens are used internally in DEBUG, but are not 
supported in the DST. They should be deleted here if they are made 
into standard VAX type codes declared in STARLET.REQ. These numbers 
may change from one release of DEBUG to the next because they must 

always be larger than DSCSK _DIYPE HIGHEST. 


Define DEBUG-internal type codes. 


DSCSK_DTYPE_AC = 38. ! ASCIC Text 

DSCSK_DTYPE_AZ = 39, ! ASCIZ Text 

DSCSK_DTYPE_TF = 40, ! Boolean True/False t Length in bits) 

DSCSK_DTYPE_SvV = 41, ! Signed pitoriers (a Lipned) 

DSC$K_DTYPE_Svu = 4g: ! Signed bit-field (unaligned) 

DSCSK_DTYPE_FIXED = 45, ! Fixed b fa: used for FIXED in ADA 
i and F ED BINARY in PL/I.” This 
: code sed the tye conversion 
; tables. in DBGEVALOP. 

! The following literals are used as CASE statement bounds internally 

; in DEBUG for the range of DTYFE codes used. 
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DBGSK_MINIMUM_DTYPE = ' Lowest internal DEBUG dtype value 
DBG$K ~MAX IMUM_DTYPE = Qs. i Highest internal DEBUG d vee value 


' The toh Lowing perventren is only used internally in DEBUG. It is 
' a DTYPE code that is Songerer’ ly put into a Value Descriptor to 
' tell the address “supeeee on interpreter that the Value Descriptor 
' came from a Literal constant. It does not nove 
A om of because it is only used during the parsing o 
i HS s. After the address expression has oso ft perees- 
s LITERAL, it is then changed to DSCSK_DTYP 


¥ -e in the above 
te icdress expres- 
f the DTYPE 


LITERAL 
secon ptwe.L3ve0a = 191; ! Value is from a Literal constant 


OTHER DST TYPE CODES 


The oye howtng literals are the DST sy codes other than VAX Standard 
Type Codes which can appear in DSTSB_TYPE. Each indicates the format 
of the record which contains it and most indicate the kind of object 
being described ¢ by that record. When eM gst records are defined, the 
type code is oe gned by makin rie oe LOW ne smaller and using that 
value. The type codes 1eb°"*, thes ok HIGHEST: u 1) are reserved, the idea 
being that cht POTYPES 1 are oreo tSocturet iy reserved to users. 
DEBUG ignores all DST records whose type.c odes are not DST$SK_BLI, in 
the renee from DSCSK_DTYPE Lveaes fo C$K ODT YPE HIGHEST, or in the 
TSK_LOWEST TO DSTSR_HIGHES 


i Define all Additional Debug Symbol Table recor g type codes. Note that the 
! BLISS Special Cases record has code zero orical reasons). ALL 
! other type codes are in the range DSTS$K “Lowest. to DSTSK_HIGHEST. 


ITERAL 
DSTSK _BLI = 0, BLISS Special Cases Record 


bSTSK_LOWEST = 153, “Lowest numbered DST record in this 
Fengen-weed te ver Pad checking 


! 
! 
' 
' 
! 
' 
! 
L 
! 
! 
1 
' 
; range D 
1 
ft 
1 
' 
! 
' 
L 


DSTSK_VERSION = 153, Version ber Record 
DST$K_COBOLGBL = 138- — Siopat . Attr oute Record 
DST$K_SOURCE = 155, Source e aereUnt ion Record 
DSTSK_STATLINK = 138. Static Link hbo 
DSTSK_VARVAL = 157, Variant Value Record 

DSTSK_BOOL = 158, atents ob} 


ect of 4 ol BOOLEAN, 
Llocated on yte. 
9 order bit = 1 if TRUE 
low order bit = 0 if FALSE. 
External-Is-Next Recere (Obsolete) 
Global-Is-Next recere, (Obsolete) 
DEBUG jaternet use onl (unaligned 
bit str ang? (Obsolete) 
Prolog Record 


DST$K ent 
DST$K—GLOBNXT 
DSCS$K_DTYPE_UBS 
DSTSK_PROLOG = 162, 
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DSTSK_SEPTYP = 163, ! Separate Type Specification Record 
DSTSKIENUMEL T = 182: : Enumerated Type Element Record 
DSTSK_ENUMBEG = 193. ! Enumerated Type Begin Record 
DSTSK_ENUMEND = 1 g. ! Enumerated Type End Record 
DSTSK_VARBEG = = 16 ; ' Variant Set Begin Recor 
DSTSK_VAREND = 1 g. ! Variant Set End Recor 
DSTSK_OVERLOAD = 18 ' ' Overloaded Symbol record 
DSTSK_DEF _L = 1 9. ! Definition Line Number Record 
SHECRS if: | Rteerg Beat cara 

mi = : ! Record End Recor 
DSTSK_CONTIN = 158" ! Continuat 90 Record 
$2t LS 09! = fe. ! Value Spe {ices on Record 
DSTSK_TYPSPEC = 175, ! Type Specification Record 
DSTSK_BLKBEG = 17 ' Block Be in Record 
DSTSK“BLKEND = = 158: i Block End Record 
DSTSK_COB_HACK = 178, ! COBOL Hack Record (Obsolete) 
: = 17 ' Reserved to DEBUG 
= 180, i Reserved to DEBUG 
DSTSK_ENTRY = 181 ! Entry Point Record 
DSTSK-LINE_NUM_REL_R14 i Threaded Code PC-Correlation 

z f ¢° ! Record (Obsolete) 

gereeuri?  ie: | pansy Ele cara 

“ = . ! ecor 
DSTSK_LINE_NUM = 185, ! Line Number PC-Correlation Record 
DSTSK-LBLORLIT = 186, ! Label-or-Literal Record 
DSTSK_LABEL 187, ! Label Record 
DSTSK_MODBEG = 188, ! Module Begin Record 
DSTSK_MODEND = 189, ! Module End Record 
DSTSK_RTNBEG = 190, ! Routine Begin Record 

a = ° ' Routine End Recor 
DSTSK_RTNEND 191 ! Routi End R d 

~ = 3 ! Highest numbere record in this 
DSTSK_HIGHEST 191 High bered DST d in thi 


range--used for range checking 
NOTE TO DEVELOPERS: 


New DST Records should not be added at gbis end of the DST record number 
range. VAX Standard Type Codes 192 - 255 are reserved to users. Hence 
DEBUG does not use type codes in that range, even though DEBUG does not 
support user-defined type codes. New DST record numbers should be allocated 
by decrementing DSTS$K EST and using that number for the new DST record. 


K 
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MODULE DST RECORDS 


The Debug syn ol Table for each separately ofr ot pst module must be 


enclosed w n a Module-Be oo bay er my pair of DST records. The 
Module Begin DST mpi ted mus be the ver sigs DST record for 

any y poperstely compiled nodule ¢ EsOs9 oe” object le) and the Module 
End record must be the ver record for the module. Only 
one ule-Be jasneduler ene pat " - at Loves n what the Linker sees 

as a single object modul t multi le G uit oniy gee. the fires pairs 
ar incl re n one ob ec nodule, ae erty ee the first such 


pair and ignore the rest because ker ut tt only tell DEBUG about 
the location of the first Module Soota record ° 


The ar tt Mle e-End pair defines a ne sco ° which con- 
tains all symbol ws 1 ned by “44 records yitns n that pa r. The module 
has the name given in the Module Begin DST record. The nee of the 
object module is also encoded in the Module Begin record. 


' 
i 
' 
i 
i 
' 
' 
' 
' 
i 
: 
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THE MODULE BEGIN DST RECORD 


1 
i 
| 
' The Module Begin DST Record marks the beginning of the DST for a module. : D 
! This DST record also gives the name of the module and the source Lan- : 0 
; guage n which the module was written. The Module Begin DST Record : © 
\ must be the the first DST record of every compilation unit ('‘module’’)  f 
‘ and it must be matched by a Module End DST Record that ends the DST for : $ 
: that module. Only one Module Begin DST Record is allowed to appear in th 
: the DST for a separately compiled object module. : 5 
This is the format of the Module Begin DST Record: : . 
i 
i teeeenne a eoceeeoeeene eemww www ww wee wewecwcccceccccccccce ey 
i byte } DST$B_LENGTH 
' meee enw ene n none e eee meee www es ewww ewww ewe none eee ee rer. 
byte DSTSB_TYPE (= DSTSK_MODBEG) H 
byte DST$B_MODBEG_UNUSED i 
} long DSTSL_MODBEG_LANGUAGE i 
byte | DST$B_MODBEG_NAME i 
i var ' H 
The Module Name in ASCII 
(The name's Length is given by DST$SB_MODBEG_NAME) 
a | 
i $noccccececoeecccccceccocce eeecoceececoccowcececcececcccccccccce + 
! 
: 
4 
: Define the fields and size of the Module Begin DST Record. 
FIELD DSTSMODBEG_FIELDS = 
DST$B_MODBEG_UNUSED = f ¢- B_ : ! Unused--Must Be Zero 
DST$L_MODBEG_LANGUAGE = ot 


' 

cs : Language code of language in 
which module was written 
' 


DST$B_MODBEG_NAME =(€ 7, 8] ' Count byte in name counted 
: ASCII string 
TES; 
LITERAL 
DSTSK_MODBEG_SIZE = 8; ! Size in bytes of the fixed part of 
: the Module Begin DST record 


! Define all the Language codes that may appear in the DSTSL_MODBEG_LANGUAGE 
! field of the Module Begin DST record. (Note that DEBUG may not actually 
} support all languages that have language codes.) 


LITERAL 


M 
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DSTSK_MIN_LANGUAGE = 0, ! Smallest Language code 
DST SE MACRO - 9. ! Macro _ 
DSTSK_FORTRAN = 1, ! Fortran 

DSTSK_BLISS = ¢° ! Bliss 

DST$K_COBOL = 3, ! Cobol 

DSTSK_BASIC = 4, ! Basic 

DSTSK_PLI = 5, ! PL/I 

DSTSK_PASCAL = . ! Pascal 

DSTSK_C = 7, ; 

DSTSK_RPG = . ! RPG 

DSTSK_ADA = ! Ada 

DSTSK_UNKNOWN = 16, i Language Unknown 
DSTSK_MAX_LANGUAGE = 10; ! Largest language code 


! Here also we define all the same Language codes using names with the DBGS$ 
! prefix. This prefix is used in DEBUG for historical reasons. These names 
: may eventually be discarded. 


LITERAL 
DBGSK_MIN_LANGUAGE = DSTSK_MIN_LANGUAGE, ! Smallest Language code 
DBGS$K_MACRO = DSTSK_MATRO, ! Macro 
DBGSK_FORTRAN = DSTSK_FORTRAN,! Fortran 
DBG$K_BLISS = DSTSK_BLISS, ! Bliss-32 
NBGSK_ COBOL = DSTSK_COBOL, ! Cobol 
DBGSK_BASIC = DSTSK_BASIC, ! Basic 
DBGSK_ = DST$K_PLI ! PL/I A 
DBG$K-PASCAL = DSTSK“PASCAL, | Pascal ¢ 
DBGSK_ = DSTSK_C a oO 
DBG$K~ = DSTSK"RPG, | RPG d 
DBGSK_ADA = DSTSK_ADA, ' Ada ( 
DBGSK_UNKNOWN = DSTSK goat Language Unknown t 
DBGSK_MAX_LANGUAGE = DST$K_MAX_LANGUAGE; ! Largest Language code ; 
D 
Language UNKNOWN requires some special explanation. DEBUG supports ‘‘unknown"’ : 


Languages with a standard set of DEBUG functionality. This standard set in- 
cludes all Languages independent functionality plus venti tgnt averes” Language 
expressions. Identifiers are assumed to allow A- 72, 0 - 9, $, and _. Symbol 
references may include pudscripging (using round () or square (3 parentheses) 
and record component selection (using dot=-notation as in A.B.C). Most simple 
operators are allowed in language expressions. 


While not officially supported, Language UNKNOWN is intended as an escape for 
compiiers which do not yet have true DEBUG support. By specifying Language 
code DSTSK_UNKNOWN in the DSTSL_MODBEG LANGUAGE field, such languages can 
take advantage of whatever support DEBUG provides for unknown languages. If 
and when true DEBUG support is provided, a new tanquege code for the new 
language can be allocated by incrementing DSTSK_MAX_LANGUAGE by one and as- 
signing that language code to the new language. 


DEBUG treats ony out-of-range _oneee code in the Module Begin DST record as 
being equivalent to Language UNK -. Use of the DSTSK_UNKN Language code 
or any out-of-range language code is intended for internal use by Digita 
only. DEBUG's yo nown= anguege support is not officially suppor ed and is 
subject to possibly incompatible changes in future releases of DEBUG. 
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i Internally, DEBUG 
! guage code above 


255° 


ts the Lan 
s truncate 


gv 


N 
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age code as a byte 
to its low-order e 


value 
ight bits 


Hence any Lan- 


TBK 


<e voereogegegst 


ae ee 
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THE MODULE END DST RECORD 


The Module End DST Record must be the Last DST record in the DST for a 

compilation unit. Its sole purpose is to mark the end of the DST for 

a separately compiled object module. There can be only one Module End 

pst ryeere per eae matching the previous Module Begin DST record. 
s is its format: 


$e new e Sew eB BSS BME BE Baer ee anmraaee wert emma meen eee nese weer wes eee + 


! 
i 
i 
i 
i 
i 
' 
i 
' 
: byte i ad = ' 
b ! DST$B_LENGTH (= 1) H 
i 
1 
i 
i 
i 
L 


cee ew ewe ee ee Sen nee wane nee nw 2 eee & Be e& we we = SKB ewe eeneee ez 2B eae ea a ema oe = w= = + 
byte H DSTSB_TYPE (= DSTSK_MODEND) H 
Define the size in bytes of the Module End DST Record. 
ITERAL 


DSTSK_MODEND_SIZE = 2; ! Size of Module End record in bytes 
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ROUTINE DST RECORDS 


A routine is represented in the Debug Symbol Table by a pair of DST 
records, nanely a Routine Begin DST record which is matched with a 
Later Routine End DST record. ALL DST records between the Routine 
Begin and the Routine End DST records represent the symbols that are 
declared in that routine or in nested routines or blocks. Nested rou- 
tines are represented in the DST by nested Rout ine-Begin/Rout ine-End 
pairs. Lexical blocks (BEGIN-END blocks or the Like, depending on 

the Language) may also be nested freely outside or inside routines, 
provided all blocks and routines are properly nested. 


Consider the following example of nested blocks and routines. If 
routine Ri contains a nested routine R2 and a lexical block 81 and 
if block B1 contains routine R3 and Block B2, the DST would have the 
following sequence of DST records: 


Module Begin for whole module 
.»»-module-level data DST records... 
Routine Begin for 

..-local data DST records for R1... 
Routine Begin for R2 
.»-local data DST records for R2... 
Routine End for R 
Block Begin for B1 
..- local data DST records for 61... 
Routine Begin for R3 
-»- local data pst records for R3... 
Routine End for R 
Block Begin for B2 
-»elocal data DST records for B2... 
Block End for B62 


r Ri 
Module End for whole module 


In addition to defining a symbol scope, the Routine-Begin/Routine-End 
air defines the name and address range of the corresponding routine. 
he name and start address is found in the Routine Begin DST record 

and the oye Length of the routine is found in the Routine End DST 

record. It is assumed that the start address is also the entry point 
to the routine. The Routine Begin record also Indicates whether the 
routine uses a CALLS/CALLG Linkage or a JSB/BSB Linkage. 


Dd 
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THE ROUTINE BEGIN DST RECORD 


The Routine Begin DST record marks the get of a routine and the 
associated $5089. This record contains the routine's name and start 
address and indicates whether the routine is a CALLS/CALLG routine 

or a JSB/BSB routine. It must be matched by a Routine End DST record 
later in the DST, except if the language of the current module is 
MACRO. (Since MACRO routines have entry points but no well defined 
end points, the Routine End rescore can and must be omitted for this 
language. This exception applies to no other Language.) 


This is the format of the Routine Begin DST record: 


byte H DSTSB_LENGTH i 
byte Hl DSTSB_TYPE (= DSTSK_RTNBEG) : ' 
$m ew ee mane eee eee ee See ee ee He ee ee SSB eee weer wr roe ene sc ec eee eeefooeoece -+ 
Long H DSTSL_RTNBEG_ADDRESS H 
byte ' DSTSB_RTNBEG_NAME ! 
var : ' 
' The Routine Name in ASCII ' 
(The name's Length is given by DSTSB_RTNBEG_NAME) 
Ee anette OOOO SOS OSS OOS SSS SSS SS SSS SSS SSSSSSSSSTSSSSSSESSSSSSSSES + 
Define the fields and size of the Routine Begin DST record. 


' 
i 
i 
i 
i 
i 
i 
' 
i - + 
i byte | DSTSV_RTNBEG_UNUSED tNO_CALL! 
! 
! 
; 
; 
i 
F 


IELD OSTORTNBES FIELDS = 


DST$V_RTNBEG_UNUSED = f - V.(0. } }- 


ad k Unused--Must Be Zero 
DSTSV_RTNBEG_NO_CALL = 


This ai is set if this rou- 


or CALLG 
The routine 


DSTSL_RTNBEG_ADDRESS = ( 3, L_ J], $s start address 
and entry point address 
DSTSB_RTNBEG_NAME =(€7, 8 ) The count byte of the rou- 
tine's Counted ASCII name 
TES; 
LITERAL 


DSTSK_RTNBEG_SIZE = 8; ! Byte size of the fixed part of the 
: Routine Begin DST record 
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' 
i 
i 
! 
' 
i 
i 
é 


THE ROUTINE END DST RECORD 


The Routine End DST Record marks the end of a routine's scope in the 
DST. It also contains the byte length of the routine's code. (Note 
that Routine End DST records must be omitted for language MACRO but 
are geneatey Fee all other Languages.) This is the format of the 


Routine End DST record: 

$ mmm ewww www ewww meee ew wooo ee eooeccocce Pewee wwe wwe eee eee ceecoonon} 
Se STEN, nF ee bine Dh AMO Oe HS 
: DSTSB_TYPE (= DSTSK_RTNEND) H 
F mesineblonscaieaig, Weed Ot Ge Set nee 
ER ee seth shinee es « See atteae ES ES 


Define the fields of the Routine End DST record. 
IELD DSTSRTNEND_FIELDS = 


Pots RTWEMD_SIZE =(€3, L. J ! The length of the routine in bytes 


F 
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LEXICAL BLOCK DST RECORDS 


A “Lexical Block’’ is any programming Language construct other than a 

routine that defines a scope within which syqbods ge te 8 
routine , 

view, is that a block is always entered by Juaping to it or ; mply 

falling into it while a routine is always entered by a call 

tion of some sort. A rout a hat can be called; 

a block does not. Hence BEGIN-END blocks in BLISS ong PL/I are blocks 

and so are Paragraphs and Sections in COBOL. Subroutines, functions, 

and procedures, on the other hand, are ‘routines’. 


Blocks and routines do have one thing in common, however. Both define 
syntactic units within which other srebets can be defined. The pur- 
pose of representing blocks in the DST is to define the scopes they 
ype os and to give the address ranges of the corresponding bodies 

of code. 


A lexical block is represented in the Debug Symbol Table by a pair 

of DST records, namely a Block Begin DST record which is matched with 
a later Block End DST record. ALU DST records between the Block Begin 
and the Block End DST record represent the symbols that are declare 

in that lexical block or in nested routines or blocks. Nested blocks 
are represented in the DST by properly nested Block-Begin/Block-End 
pairs. Routines and blocks may freely be nested within one another, 
yenn fhe esorepr tate proper nesting of the corresponding Begin and 

n records. 


The start address of a block's code is given in the Block Begin DST 
record and the byte length of that code is given in the Block End 

DST record. The name of the block is given in the Block-Begin record. 
If a block has no name (which is common for BEGIN-END blocks), the 
null name is piven (the name of Length zero). Locks with null names 
cannot be explicitly referenced in DEBUG, but Line numbers within such 
blocks can be used to specify breakpoint locations or symbol scopes. 


! 
i 
' 
' 
' 
i 
i 
i 
f 


a -_ —_ 
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THE BLOCK BEGIN DST RECORD 


The Block Begin DST Record marks the beginning of a Lexical block and 
the associated scope. This record contains the block's name and start 
address. It must be matched by a Block End DST record later in the 
DST. This is the format of the Block Begin DST record: 


¢ we emer erm emwom meme eee eeec] — -eerrrcecerrr ec e2 rt eB eer weocewmeart eee eet eenree2eeceree = + 


1! 

i 

i 

i 

i 

i 

i 

; 

i byte 3 DSTS$B_LENGTH 
. ee ew BE ee ere ne ee ee = Temes see ee te BO eee RBM mE emo mE Dome De ran eran co ea + 
byte ! DSTSB_TYPE (= DSTSK_BLKBEG) H 
4 See ee ee Boe ere see owe—ewe = Sere SC eS Few HSB OBO BRS Seer wZo ese ew ewe ee Se ee ow = wee mem } 
byte ‘ DST$B8_BLKBEG_UNUSED ! 
long i DSTSL_BLKBEG_ADDRESS i 
byte | DST$B_BLKBEG_NAME : 
ivar 3 ' 
; The Block's Name in ASCII ' 
(The name's Length is given by DST$8_BLKBEG_NAME) 
Beh | 
i $eee eee eee eee eee ee eee eee SORE ORE OR OM OS wore een ena $ 
' 

: 

Define the fields of the Block Begin DST record. 

FIELD DSTSBLKBEG_FIELDS = 


! Unused--Must Be Zero 

' The block's start address 

! The count byte of the block's 
! Counted ASCII name 


DSTS$L_BLKBEG_ADDRESS = 
DST$B8_BLKBEG_NAME = 


TES; 


DST$B8_BLKBEG_UNUSED = 5: B 


ss 
= 
Le 
eee) 
se. 


H 
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THE BLOCK END DST RECORD 


The Block End DST Record marks ghe end of a Lexical blo¢ k’s scope in 
he DST. It also contains the byte ‘ones of the block* s code. This 
s the format of the Block End DST record 


tower rere ere ne ee eer owe eee swore cee eos wert ew sete eee eee ewe weer em eee = $ 


! 

{ 

' 

' 

! 

! 

' 

! 

i 

i byte i DSTS$B_LENG’H (= 6) : 
byte i DSTSB_TYPE (= DSTSK_BLKEND) i 
| byte : Unused (Must Be Zero) ! 
Long i DSTSL_BLKEND_SIZE i 
i 

Define the fields of the Block End DST record. 

FIELD DSTSBLKEND_FIELDS = 


PS TSL BLKEND_SIZE =(€3, tL. J! The byte Length of the lexical block 
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DATA SYMBOL DST RECORDS 


Data symbols are represented in the Debug er Table by data DST 
records which come in several varieties. All such DST records give 
three pieces of information about each symbol: the data type of the 
syapol. the value or address or the symbol, and the name of the 
symbol. 


The Stonder¢ Data DST record is the simplest form of data DST symbol 
record and is used for most ordinary atomic data objects. It repre- 
sents the data type by a one-byte VAX Standard Type Code. t repre- 
sents the value or address of the syste} by a prapte five-byte encoding 
capable of specifying 32-bit Literal values, absolute addresses, reg- 
ster locations and arereeses computed as offsets from a register. 
possibly including ndirection. It is also possible to specify that 
the computed address is the address of a VAX Standard Descriptor for 
the data symbol. Finally, the name is represented as a Counted ASCII 
character string. 


There are several reasons why a ptendece Data DST record may not be 
adequate to represent a data symbol. First, the symbol's data type 
may be too complicated te represent by a one-byte type code. In this 
case, one of several available escape mechanisms must be used so that 
expanded type information can be included in the symbol's DST informa- 
tion. Second, if the symbol is a Literal (a named constant), its 
value may be too Large fo fit in one longword. jn this case, an ex- 
panded value specification must be used. And third, if the symbol is 
a variable, its address may be gpec ti tee by a more Congl tcated compu- 
tation than can be represented in the Standard Data DST record. In 
gate cate, an escape to a more complicated value specification must 
used. 


Expanded type specifications come in three main forms: Descriptor 
Format DST records, Separate Type Specification DST records, and 
various specialized DST records that handle various special kinds 
of data types such as record structures, enumeration types, and 
BLISS structures. 


Descriptor Format DST records are used when the data object must be 


described by a VAX Standard Descriptor and has a etatie address. A 
packed decimal data object. for xample must be described by a 
descriptor that speci! es the object s length and scale factor. If 


a descriptor exists in user memory at run-time, the Standard Data 

DST record can be used, but otherwise it is necessary to include the 
descriptor directly in the DST within a Descriptor Format DST record. 
These DST records are used for all static arrays and other data objects 
that can be described by VAX Standard Descriptors. 


For data types that can be described by neither onecbyte type codes 
nor VAX Standard Descriptors. a Separate Type Specification DST record 
must be used. In this case the DST record's tyes field indicates that 
the type sepctt cation is found is a separate DST record which imme- 
diately follows the present DST record. The DST record that rot lous 
must be a Type Specification, Record Begin, or Enumeration Type Begin 
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DST forerd. These records can describe all data types supported by 
DEBUG in full detail. 


As mentioned above, the third data type ‘‘escape’’ mechanism is to use 
one of a number of specialized DST recerts that describe data symbols 
oft epec al kinds. BLISS structures and fields, for example, are de- 
scribed by special DST records, as are orumeres ten type bey eng 
These DST records will not be further described in this section; they 
are described elsewhere in this definition file. 


Expanded ‘Value Specifications’ must be used i. data symbols whose 
values or addresses are too long or too complicated to be described 
by the Standard Data DST record. A _D-Floating constant, for example, 
has too Large a value (8 bytes) to fit in a Standard Data DST record. 
A “based variable’’ in PL/I may require a complicated computation or 
even a call on a compiler-generated thunk fe compute the variable's 
address. for these and other cases, a Trailing Value Specification 
DST resers must be uses. Such a record includes a Value Specifica- 
tion which may be arbitrarily complex. 


Trailing Value Specification DST records are sometimes used to speci- 
fy both type and address information. An array with dynamic array 
bounds, for instance, must be described in ye DST if no descriptor 
exists in user eed | at run-time. A Trail ng Value Specification 
can be used to compute the entire descriptor for such an array at 
DEBUG-time. The descriptor then gives both the array address and 
type information such as the element type and the array bounds. 


' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
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THE STANDARD DATA DST RECORD 


The Standard Data DST record is used to describe most simple scalar 
data objects such as intepers. floating-point numbers, and complex 
numbers. The data Fype s reeregentes by the one-byte VAX Standard 
Type Code in the DSTS8 TYPE field. The value DSTSK_BOOL is also 
accepted; it denotes that the data symbol is a Booléan variable or 
value which is TRUE if the low-order bit is set and FALSE otherwise. 


The value specification in the Standard Data DST record indicates 
the symbol’s value or address or how to compute the symbol's address. 
The details are found below. 
This is the format of the Standard Data DST record: 
ooo Pewee ewww ewww wee w www ewe eoeoooocoe a+ 
byte ‘ DSTS$B_LENGTH H 
byte ; DST$B_TYPE ' 
pecs wer sees ese te eeee ee 2 eoeceee ep¢oeocee- of eceeeesesoece --4+ 
byte H DSTSV_REGNUM | SisP i INDIR H DSTSV_VALKIND H 
eeeeee een wow e rer re wreeeeer nee wee =~ Gewese cee —s a = oS Se oe Se Se Sw De Ow ow we 
long H DSTSL_VALUE H 
byte H DST$B_NAME H 
var H ' 
' The Symbol Name in ASCII 
(The name's length is given by DSTSB_NAME) 
Ticnaselinasidaii SS Qeeeeeoeeeooeooe2 SSSS2S2SSSSSSSSSSSSSSSSESESSES8E2S8SEES9202 en | 


Define the fields of the Standard Data DST record. These fields are also 
used in many other DST records of similar formats. 


IELD DSTSSTD_FIELDS = 
SET 


EEE EOE EEE EEE EEE EEG ee 


DSTS$B_VFLAGS = - 8.1). poluen? lage (access information) 
DSTSV_VALKIND = - V.(0,2)],! How to interpret the specified value 
DSTSV_INDIRECT = - V6 §-3,°! Set if ogeress of address is produced 
y indicated computation (do an 
ndirection to coneute address) 
DSTS$V_DISP = C 2, v.(3) J, ! Set if content of DSTSL_VALUE is used 


as a splecenent off a register 

specified in DSTSV_REG 

Number of register used in displace- 
ment mode addressin 

Value, address, or bit offset 

Count byte of the symbol name field, 
a counted ASCII string 


DST$V_REGNUM = C 2, v_(4,4)], 
DST$L_VALUE = f 3° . - 
DST$B_NAME ° 


Oe me me et ee me te tae 
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TES; 


Define all special values that may appear in the DSTSB_VFLAGS field. If one 
of these vejues gopeers n that field, the DSTSL_VALUE field bes some special 
cated gh cases, the DST 8 VFLAS sub- 
fields have no meaning. Not all of these special values may appear in a 
Standard Data DST record (see the comments bie AM they are all Listed 


! 

i 

} meaning ind 

i 

: here for completeness. Note that these values (with one exception) all have 
L 


the special value. In su 


the top four bits set--hence ney cannot be normal VFLAGS values since the 
REGNUM field cannot contain 15 (indicating the PC) in a normal VFLAGS value. 


ITERAL 
DS1SK_VFLAGS_NOVAL = 128, 4 flag which indicates that no value 
s specified i F the object 
being described is a type. This 
value may only appear in a Record 
Be records 
This value is DSTSB_VFLAGS signals a 


DSTSK_VFLAGS_UNALLOC 249, 


4 

i 

i 

! 

i 

i 

i 

: allocated (and hence has no 

} address). For example, PASCAL 

i does not allocate variables 

: that are not referenced. 

! This value in DSTSB_VFLAGS signals a 
} Descriptor Format DST record 

! This value in DSTSB_VFLAGS signals a 
! railing Value Spec DST record 
' Value Specification Follows (allowed 
: only in a Trailing Value Spec) 
! A flag see Teos tne that DSTSL_VALUE 

! contains a bit offset (used 

; only for record components) 


DSTSK_VFLAGS_DSC = 250, 
DSTSK_VFLAGS_TVS = 251, 
DSTSK_VS_FOLLOWS = 253, 
DSTSK_VFLAGS_BITOFFS = 255; 


Provided the DBG$B_VFLAGS field does not have one of the above agec tat values, 
the DBG$SV_VALKIND field indicates what kind of value or address is computed 
by the value computation. The possible values of this field are defined here. 


| tt 


ITERAL 

DSTSK_VALKIND_LITERAL = 0, ! DSTSL_VALUE contains a Literal value 

DST$K_VALKIND_ADDR = 1, ! Computation produces the address of 
} the data object 

DSTSK_VALKIND_DESC = 2, ! Computation produces the address of a 
; VAX Standard Descriptor for the 
; data ob ost 

DSTSK_VALKIND_REG = 3; } Value is contained in the register 


whose number is in DSTSL_VALUE 


If the DSTSK_VFLAGS field does not contain one of the special values Listed 
above, then the computation that produces the value or address of the data 
object proceeds as follows: 


1. If the VALKIND field contains PSTSK VALE INO LITERAL, the symbol is a 
constant whose value is given by thé DST$L_VALUE field. Such constants 


# 
TBKDST.REQ; 1 16-SEP-1984 16:58:14.08 Page 39 TBk 


can be up to 32 bits Long. 


2. If the VALKIND a that contelos DSTSK_VALKIND_REG, the synbo} is a vari- 
a e bound to ster. e register number of that register is 
ven by the DsTSte VALUE Held. 


3. Otherwise, the symbol is a variable with a non-register address. To 
compute that address, the DSTSL_VALUE Held is picked up. 


4. f the DST$V =BISF eas Me set, the contents of the register whose reg- 
ster number i o give by the DSTSV_REGNUM field is added to the value 
picked up from the DSTS VALUE field. 


5. If the DSTSV_INDIRECT bit is set, the address senquted so far is treated 
as the saarees of a pointer that points to the actual data object. In 
other words, an indirection is done. 


6. If the value of the VALKIND field is DSTSK_VALKIND_ADDR, the address 
computed so far is treated as the address Of the data object . 


7. If the value of the VALKIND field is DSTSK_VALKIND_DESC, the address 
computed so far is treated as the address of a VAX “Standard Descriptor 
ag the data object. The actual address of the object, along with its 
other attributes such as type and size, must therefore be retrieved 
from that descriptor. 


As this pecified tn, indicates, a°Data 83} yt a address computations 
can be speci iy n the ee a Data DST record. By example, the address 
of the second f orenes er to a routine, passed by reference, can be 
described by m nak ing 06 V_REGN NUM = 12 (for rosteter AP), ALUE = 8 
(to indicate an offset “ “8 pytss Ne AP to get at the’ second” ~longvor rd in 
the argument vector), ode SP = 1 (to indicate that DST$L LUE is to be 
treated as a displacement off AP), bed DSTSV_INDIRECT = 1 (to 4 ndicate an 
indirection since the argument is passed by by reference). DSTSV_VALKIND = 
DSTSK_VALKIND_ADDR in this case. ger rameter were passed “by descrip- 
tor, however, DST$V_V VALKIND should be DSTSK_VALKINKD_DESC, with all other 
fields having the same values as in the passed-by-reference case. 


N 
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THE DESCRIPTOR FORMAT DST RECORD 


The Descriptor Format DST re 4% hy onee? when a VAX Standard 
Descriptor must be included T for a static $y ymbol. It 
includes the descriptor direct S. A th DST record rig 

the name field. This record 8 essentially identica 9 the 
Standard Data DST record except that the 2 TSB_VFLAGS field has 
the poecial value st K_VFLAGS_DSC and the DSTSL =VALUE field is 
a relat 4 

This is the eens 


pee men oc es we eee seeeee eewrwrewrnroeerreocrewmeroeeoreen eee eae = Sw ese ac aaae + 


' 
' 
L 


Denage EMPRESS RI oe | 
pated, ENS, i. SEER EE 
mee eudiniubeabeleaberieteseese cet tiaetmianinnmiaeel 
tea suleamouteqetiicesierstanietinagnia ieeiesioniniak 2 
Deg MIE 8 BDF can 

: var 


The Symbol Name in ASCII 
(The name's Length is given by DSTSB_NAME) 


a 
} eeeececoce coco cece 


' 
1 
i 
' 
' 
' 
{ 
' 
' 
' 
' 
' 
! 
' 
1 
' 
' 
‘ 
J 
‘ 
' 
' 
' 
' 
i] 
‘ 
4 
' 
' 
i] 
4 
' 
‘ 
' 
‘ 
' 
4 
' 
a 
t 
' 
i] 
' 
‘ 
‘ 
' 
' 
F 


ee ooo ooo eoeeennnne + 
' Long : DSC$B. CLASS ! DSC$B_DTYPE ! Dscsw_ LENGTH lo 
i long | DSCSA_ POINTER 
' teeceeonene oo et ee er '¢ 
' var : : . 4 
Other VAX Standard Descriptor Fields i 
depending on the descriptor class i | 
iy 
$eewwnnnnnnnnne Sooo wo ew wenn none momen nnn nnn neee + .. 
ae | 
: 
i Ln 
! Define the fields of the Descriptor Format DST record. 
FIELD DSTSDSC_FIELDS = 
DSTSL_DSC_OFFS =C€ 3, tL. J, ! Offset in bytes to descriptor 
: from DST$A_DSC Bnet 
DSTSA_DSC_BASE =(€7, AL J ' Descriptor starts af this loc- 
' : ation + DSTSL_DSC_OFF 


TES; 


—!::.,.a— or 
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: Note that the address of the descriptor is computed as follows: 
i DST_RECORDCDSTSA_DSC_BASE] + .DST_RECORDCDSTSL_DSC_OFFS] 
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THE TRAILING VALUE SPECIFICATION DST RECORD 


The e spect veiye Specification DST record is used are -  Supenees 
value ~via ication is needed to compute a ae as toys lue or 
address. ncludes a Verue.s Specification a} rect n the DST rec- 
ord } ght Sleer the name This record 78 essentiall identical 
to the Standard Data DST record eecens epee th rhe. DST$B_VF - rs field has 
the special value DSTSK_VFLAGS_TVS and the D VALUE f 
relative byte offset to “the Valtue gcestticotton "Sacer A tis record. 
This is the format: 


byte H DST$B LENGTH ! 
byte H DSTSB_ TYPE. H 
byte : ~ DSTSB_ VFLAGS (= DSTSK -VFLAGS_ TVS) _ H 
Long ! DSTSL -1VS OFFSET eet 
byte ! __DSTSB_ NAME (also DSTSA_ TVS BASE) © 
var H ' 
The Symbol Name in ASCII 
(The name's Length is given by DSTS$B_NAME) tee 
(uinienieningmenngtdnenmnnpR a beNinnEienmeananNNn Se 
var H {<-=+ 
i DST Value Specification 
M eee et en tee eee ne = Sete TE eT OSE HOT BE EO SET OS RE DOE BE SEO SME BBE OS MOSS ; 


Define the fields of the Trailing Value Specification DST record. 
FIELD DSTSTVS_FIELDS = 
DSTSL_TVS_OFFSET = (3, L. J, Offeeg | in in bytes aT ae Value Spec 


DSTSA_TVS_BASE =(€7, AL J] sreliiee Value Spece tarts at this 
i location + .DSTSL_TVS_OFFSET 


i ee ee eee 


TES; 


i Tol tows that the address of the trailing Value Specification is computed as 
° 


DST_RECORDCDSTSA_TVS_BASE) + .DST_RECORDCDSTSL_TVS_OFFSET) 


f 
¢ 
Vv 
t 
vi 
t 
A 
o 
a 
r 
T 
T 
t 
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' Also note that Value Specifications are described in a separate section 
' Later in this definition file. 4 
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THE SEPARATE TYPE SPECIFICATION DST RECORD 


The Separate Ty9¢ Specification DST record is used when fhe data type 
of the erates ein ribed by a 

e tye This DST record 
must be immediately followed by a Type Specification, Record Begin, 


a Trailing Value Spec ivigation if poceseery to describe the symbol's 
e record: 


gem en oe nrecece wT HOB eee wane meres ene oe meee nen mse om se eee ewrceae mn eocace + 


a Senna teeta tonindenumiatciteieaie aia 
Sepp STS RIE oe Ph, dh edhe = hs AP OEE ; 
sig, mises cot th an th eae SOO ABET: A Eel OTA : 
ee SS RI deo SOE POD Sak line ; 
saat SS RE RAO 2 PF a REE Sea CEE oat i 
os ! The Symbol Name in ASCII | 
(The name's Length is given by DSTSB_NAME) 
SSR ec si a el EE ters bd 
wc A Trailing Value Specification or nothing, | 
depending on the value of DSTSB_VFLAGS field 
EP ESP iT Oc SR Se TET I a te : 


' 
i 
' 
' 
' 
' 
i 
F 


F 
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DST VALUE SPECIFICATIONS 


A DST Value Specification specifies the value or address of some symbol. 

Value Specification can occur in a number of pyeces in the Debug Symbol 

Table. The simplest forms of Value Spegit cations occur in the Standard 
cated form eceyre in seer tor 

Format DST records where a VAX Standard gt hi ae s included in the 

DST record to give more coy tty gceress nformation (and t 

tion). The Trailing Value Specificat 


Data DST record. A somewhat more compl 


ype informa- 
on DST record has a simple five- 
byte Value Specification et the beginning of the record which points to 
amore c lex Value Specification at the end of the record. That more 
complex Value Specification can be any kind of Value Specification, in- 
cluding the most general forms. 


In addition, Value Specifications ney occur in a number of Type Speci- 
fications. In these cases, they typically generate values (as opposed 
to addresses), such as subrange pecs for a subrange data type, or they 
enerate full VAX Standard Descriptors in order to specify some sort of 
ata type, such as a dynamic array. 


1 

i 

i 

i 

i 

i 

i 

i 

i 

i 

i 

i 

i 

i 

i 

i 

i 

i 

i 

i 

i 

1 

: ALL Value Specifications start with one byte, the DSTSB_VS_VFLAGS field. 
: In Standard Data DST records, this field and the DSTSB_VFLAGS field are 
: synonymous. If this field has one of the special values DSTSK_VFLAGS_xx 
‘ described in the Standard Data DST Record section above, the format of 
: the Value Specification depends on that value. Otherwise the VFLAGS 
: field is interpreted as a set of subfields, namely DSTSV_VS_REGNUM 

! DSTSV_VS_DISP, DSTS$SV_VS_INDIRECT, and DSTSK_VS_VALKIND. “This is also 
described in detail in the Standard Data DST Record section above. 

' 

i 

i 

i 

' 

i 

i 

i 

i 

i 

i 

i 

i 

i 

i 

i 

i 

i 

r 

i 

F 


STANDARD VALUE SPECIFICATIONS 


As indicated above, if the DSTSB_VS_VFLAGS field does not have a special 
value, the Value Specification is a Standard Value Specification and has 
the following structure: 


+ 
byte DST$V_VS_REGNUM { DISP { INDIR } SV_VS_VALKIND } 


deterrent ewe en eer e ees sme mee Se eee Goeweeeoee}ooeoece tere eee were cece & 


long } DST$i_VS_VALU 


geueworene eee eoeeeeeoe SSS SSSSSSSSSVSSSSSSSSSSSSSSSSSSSVSSSSSSSSSSSSESee e 


Define the fields of the various kinds of Value Specifications. Also define 
the declaration macro. 


IELD DSTS$VS_HDR_FIELDS = 
SET 


DST$SB_VS_VFLAGS = f g. B_ }: ! Value-flags (access info) 
DSTSV_VS_VALKIND = - V.(0,2) J, ! How to interpret the value 


Eee eee 
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DSTSV_VS_INDIRECT = « Vi(2) J. ! Set to get indirection 
DST$V_VS_DISP = ° y7(8} }: i Set or register di splacenent 
DSTSV_VS_REGNUM a » Vi(6,4) oF i Register number for indexing 
DST$L_VS_ VALUE = eo he ae ! Value, gddr ddress, or bit offset 
DSTSL_VS_DSC_OFFS ett. t. as Of 6, n artes te to seecr see 

: rom 
DSTSA_VS_DSC_BASE =(€5,A,], ; Descr tor sterts ee “this is 

. n 
DSTSL_VS_TVS_OFFSET e®ft,t. 3 Orteey n p tes t3 VElue spec 

. om 
DSTSA_VS_TVS_BASE ={€5,Aa_,], vanes Hone DSTEA a sis oritr 
DSTSW_VS_LENGTH sC i, &, J. Length of Va ‘ ett » ter tes 

: not countin @ 

: and VS_LENGTH ee 
DST$B_VS_ALLOC = f 3, BL }: ! Allocation Tndica 
DSTSA_VS_MATSPEC =(€ 4, AL Lecet ion of. Raterial ization 

: ecification 
TES; r 


MACRO 
DSTSVAL_SPEC = BLOCKC BYTE) FIELD(DSTSVS_HDR_FIELDS) %; 


The following Literal values may appear in the DST$B_VS_ALLOC field. 
LITERAL 


DSTSK_VS_ALLOC_STAT = 1, ' Value is static 
DSTSK_VS_ALLOC_DYN = 2; ! Value is dynamic 


! Define the fields of the Materialization Specification. Also define the 
declaration macro. 


F1eLD estes FIELDS = 


SET ~ 

DSTSB_MS_KIND =({0, 8], ! The kind of value produced 
DSTSB_MS_MECH o£ is C. ae ! The mechanism whereby produced 
DSTSB_MS_FLAGBITS = . 8. ! Flag bits 

DST$V~MS_NOEVAL = £ 2, v~(05 }. i purpose of this bit not clear 
DSTSV_MS_D G = - V.41) J, ! Include dummy argument on call 
DSTSA_MS_MECH_SPEC = a i }: ! Location of Mechanism Spec 
DSTSL_MS_MECH_RTNADDR = xq ! Routine address for call on 
res : compiler-generated thunk 


MACRO 
DSTSMATER_SPEC = BLOCKC,BYTE] FIELD(DSTSMS_FIELDS) 2; 


The following values may appear in the DSTSB_MS_KIND field. 


BYTADDR = 1, ! The value is a byte address 
BITADDR = 2, ' The value is a bit address (a longword 
: yte address plus a longword bit 


' 
i 
i 
i 
F 
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byte 
long 


var 


var 


DESCRIPTOR VALUE SPECIFICATIONS 


If the DSTSB_VS_VFLAGS field no | fre special value DSTSK VELAGS DSC. 
this is a descriptor Value Specification. Such a Value Spec! ifation 
contains an offset relative to the end of the Value Specification that 
gotats to a VAX Standard Descriptor later in the same DST record. That 
descriptor then contains the actual address that the Value Specifica- 
tion seeks to specify. This is thus the format: 


teow mere en ee ee eee RB eH HR PB HT ER RRR OR Oe eH ee eee Be eee een} 


' DSTSB_VS_VFLAGS (= DSTSK_VFLAGS_DSC) 


SE aenetaltetesieietiekadeeietiadkateetatataieietataieatetetattaaae teeta eee eS 


' DSTSL_VS_DSC_OFFS H 


gone eeee eeeeeeeeoe SSS Se S222 eee eeeenene o> eS ee oe Se ee wes eeec owen es $ 


DSTSA_VS_DSC_BASE 
Other Fields in DST Record 


iy 
a 
t 
+ 


} ewsccecoccccece 


VAX Standard Descriptor Giving Symbol Address 


D oe cw we coon } co ceccccce 
} ecewcccenn } co eo ccceoe 
A 
a 
4 


The address of the VAX Standard Descriptor is computed as follows: 
DSC_PTR = VS_PTRCDSTSA_VS_DSC_BASE) + .VS_PTRCDSTSL_VS_DSC_OFFS); 
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byte 
Long 
var 


var 


TRAILING VALUE SPEC VALUE SPECIFICATIONS 


If the bSTs8.V5 VFLAGS field has the special +s bpd DSTSK_VFLAGS_TVS, 
this Is a Tra Ling Value Spec Value Specification. Such a Value 
Specification contains a po 


neer cetet ve to DSTSA_VS_TVS_BASE that 
points to another Val peci oe on later in the same DST record. 
his second Value Specif cation ; normally of the most general and 
poverty! form of Value Spec rreet on, namely the VS-Follows Value Spec- 
fication. In effect, the Trailing Value Spec format is a five-byte 
Value Specification (small enough fit in a Data DST Record) which 
points to a larger oye Specrt cation elsewhere in the same DST record. 
his larger Value Specification gen be arbitrar y large and complex 
in order to do whatever computation is necessary to obtain the desired 
value, address, or descriptor. 


This is the format of the Trailing Value Spec Value Specification: 


tm wre em we mm en ee nee eee ee eee ee ewe eee met ewe em ewe mere eee ee eee tee ew eee} 


i DSTSB_VS_VFLAGS (= DSTSK_VFLAGS_TVS) i 
DSTSL_VS_TVS_OFFSET tenes 
DSTSA_VS_TVS_BASE 
Other Fields in DST Record 
<--+ 


The Trailing Value Specification 
(Normally a DSTSK_VS_FOLLOWS Value Specification) 


Pee eee a 
o 
t 
4 
t 
' 
£ 
‘ 
4 
i] 
i) 
a 
a 
4 
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o 
g 
4 
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' 
a 
t 
‘ 
a 
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t 
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a 
$ 
' 
] 
‘ 
3 
o 

ee eo 


The address of the Trailing Value Specification is computed as follows: 
TVS_PTR = VS_PTRCDSTSA_VS_TVS_BASE] + .VS_PTRCDSTSL_VS_TVS_OFFSETI; 


ed ee teed Dl 


K | 
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VS-FOLLOWS VALUE SPECIFICATIONS 


If the DSTSB_VS_VFLAGS field has fre special yelye DSTSK_VS_FOLLOWS, 
this is a VS=Follows Value Specification. This is the most ognere 
and powerful form of Value Specification. The spec fication itsel 
can be arbitrarily long, but it can re do an arbitrarily complex 
computation in order to compute the desired value, address or de- 
scriptor. This is the format of the VS-Follows Value Specification: 


tore mene He See OCR OB eRe COR OHO REDO EEO Owe O EES SB ee De ee eee owen} 


hands SUEUR 8 aN tk nn Di ten nt ha ant | 

ent OC) | ae". i een ; 

eT cain | i. cepeisiiaad 

var} DSTSA_VS_MATSPEC v 
A Materialization Specification | 
ciennaiata cinemnecaniiaiees vanatemriasdninens EE 


A VS-Follows Value Specification contains a Materialization Specifica- 
tion which indicates how the value is materialized. This specifica- 
ae indicates what kind of value is being produced, by what mechanism 


S recused. and in detail how it is produced. it also contains 
some flag bits. 


The kind of value being produced can be a agibit pyte address, a A-vic 
bit address (a byte address followed by a 52-bit bit offset), a bit 
offset (relative to the start of a record--used only for record compon- 
ents), a literal value (a gonetens or ‘R-value’’), a register address, 
or an actual VAX Standard Descriptor. VAX qteqeere Descriptors are 
mainly produced by Value Specification within Type Specifications where 
a descriptor must be purty to describe a data type such as an array 
type with run-time subscript bounds. 


Values can be produced by two socheniens. One is a routine call on a 
comp | or-pener ted thunk. In this case. the compiler generates a rou- 
tine in the object code which when cal "+ produces th Gog trod yolus. 
The address of the routine is speci n the Mechanisa Spec fication. 
The ether mechanism is a DST Stack Machine routine. The DST Stack 
Machine is a virtual machine which DEBUG eauletes. To use it, the com- 
iler generates code for this virtual machine which, when executed at 
EBUG-time, produces the desired value. The DST Stack Machine form of 
Mechanism Specification constitutes the most general and powerful form 
of value specification supported by DEBUG. 


ee eee ee et ee 
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byte 
word 
byte 
byte 
byte 
byte 
long 
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CALLS ON COMPILER-GENERATED THUNKS 


The Routine Call Mechanism Specification specifies the address of a 
compiler-generated routine (a thunk) which DEBUG can call to per rere 
the desired value computation. This form of Mechanism Specification 
must be used for PL/I “BASED’’ variables since the address of such a 
variable can depend on the value returned by a user-defined function. 
In this case, the Mechanism Sper cation consists of a single longword 
giving the address of the compiler-generated thunk to call. 


This is the format of the whole Value Specification when the Routine 
Call Mechanism Specification is used: 


bw owem ema emaaae se2eee SSS SSSSSSSSSSSSSSSSSSSSSSSSSSSSTSSSSS“ISIOSISOOSO® rt a 


t DSTSB_VS_VFLAGS (=DSTSK_VS_FOLLOWS) i 


+ eee eeeeoeeoe SPSS He Be Be RO RE RO EMO MOM HE HO BSS OS ee w BeBe Bema eanonen $ 


i DSTSW_VS_LENGTH (= 8) ' 
i DST$B_VS_ALLOC (= DSTSK_VS_ALLOC_DYN) ' 


+< oeeee SS SF OSS 8 FO Pe GTB Se eee T BSF SC SPSS BZTSOSeVTOwrsI ewe wwreowereowrewrreeroa + 


; DST$B_MS_KIND 


> eSeeeeeeeoee SS SS SS SSS SSS SSSSSSSSSSSSSSSSSSSSSSSSSSISOSSISOSSISISS&* SES or 


DST$B_MS_MECH (= DSTSK_MS_MECH_RTNCALL) 


foro emo an cease ames CeO TONE emo NDE SST ETO DOSE wa wrewaene mame + 


H DSTS$B_AS_FLAGBITS i 


gewoon em een oer ee mower ee anes i ee seeeceece wa oea td 


DSTSL_MS_MECH_RTNADDR 


yoeecees Swen ene sme erm mew ie eee ee ae h 


The called routine is passed the address of a vector of register values 
as its one argument. This vector contains all register value for the 
scope (call frame) in which the symbol having this Value Spec it ication 
is declared. The vector contains the values of registers RO - R11, AP, 
FP, SP, PC, and PSL in that order. The routine is allowed to use all 
such values in its computations, but is not allowed to change the con- 
tents of the register vector. in addition, the routine is passed the 
value of FP (the Frame Pointer) in register R1. 


The value of the routine should be returned to DEBUG in register RO. 


The DSTSV_MS_DUMARG bit should be set in the DSTSB_MS_FLAGBITS field if 
the called routine expects to return a value longer than one longword. 
If DSTSV_MS_DUMARG is set, the address of an octaword (four-longword) 
buffer is passed as the first argument to the called routine with the 
expectation that the routine'’s value will be returned to this buffer. 
The address of the register vector is then the second argument. 
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TBKDST.REQ;1 


byte 
word 
byte 
byte 
byte 
byte 


var 


M 
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THE DST STACK MACHINE 


The DST Stack Machine is a virtual machine emulated by DEBUG. This 
machine can push and pop values gn a stack and ren perform a yorwers 
of arithmetic and logical operations. It can also call compiler- 
generated thunks. The DST Stack Machine is used when a value must be 
computed at DEBUG-time and the Standard Format Value Specification is 
not adequate and a compiler-generated thunk to do the whole computation 
seems undesirable. In such Cases, the compiler can generate a Mecha- 
nism Specification which consists of code for the Stack Machine. At 
DEBUG-time, when the value in quest on is needed, DEBUG will interpret 
this code until the STOP instruction is encountered. The value that 
hy Bede | = oe top of the Stack Machine stack is then taken to be the 
esired value. 


The format of the whole Value Specification when a DST Stack Machine 
Mechanism Specification is used is as follows: 


‘ DSTSB_VS_VFLAGS (=DSTSK_VS_FOLLOWS) 


tue ocmwmoanrenanmce eer ee eee meee See esate se Ses eee seme eo ee ee a 


; DSTS$W_VS_LENGTH 


donee mmm r cern wes eweeoe = eeoeoeoe SSS SSS SSSSSSSSSSSSSSSSSSSSSSSSSSEE2S22202 + 


i DST$B_VS_ALLOC i 


+ a ee ED Ge sy Ge Om SO OD eB Se ee ee Ge ee ee ce a em oe a om oe (ce we mm er cm me ee se Se weoea + 


i DSTSB_MS_KIND i 


+ eeeeeeeee ewer rr ete 22 er @ eros encore wer eowoe weer ree werner ern wren wore eran ae = + 


DSTSB_MS_MECH (= DSTSK_MS_MECH_STK) ' 
DST$B_MS_FLAGBITS H 


DSTSA_MS_MECH_SPEC 
DST Stack Machine Routine 


} cece wecnon  -= } oe 


See ee e2eeeeeneeoeeoe S222 S222 S22 S22 22222222828 SSS 2222 SSS SSS SSS S222 222282 + 


Here the DST$B_VS_ALLOC field should have the value DSTSK_VS_ALLOC_DYN 
if any kind of address is computed and DSTS$K_VS ALLOG STAT if a literal 
value (a constant) is computed. The need for this fiéld is not clear 
since DEBUG ignores it at present. 

The stack upon which the DST Stack Machine operates consists of 256 
locations where each location is a longword. The stack grows toward 
smaller addresses and shrinks toward larger addresses; in this regard 
it is Like the VAX call stack. A DST Stack Machine Routine cone ists 

of a sequence of Stack Machine instructions ending in a STOP instruc- 
tion (DSTSK_STK_STOP). When the machine stops, the op location or 
locations on the stack constitute the value of the routine. The length 
of the value is determined by the DSTSB_MS_KIND field. 


N 
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The DST Stack Machine supports the instructions tabulated in the re- 
mainder of this section. Each instruction consists of a one-byte op~ 
code followed by zero or more operand by Fes. depending on the op-code. 
In this Goscrip jon, the “'top’’ stack cell refers to the most recently 
pushed cell still on the stack and the ‘‘second’’ cell refers to the next 
most recently pushed cell still on the stack. Each cell contains a 
Longword value. 


Define the Push Register instructions. These instructions push the indicated 
register value on the Stack Machine stack. The register va ues are taken from 
ein 


‘ 
i 
! 
i 
i 
i 
i 
i 
i 
' 
' 
J 
: the scope (call frame) of the symbol for which the value is being computed. 
L 


ITERAL 
DSTSK_STK_LOW = 0, ' Lower bound for range checking 
DST$K_STK_PUSHRO = 0, ! Push the value of register 
DSTSK_STK_PUSHR1 = 1, ! Push the value of register R1 
DSTSK_STK_PUSHR = ¢ ! Push the value of register R 
DSTSK_STK_PUSHR = 3, ! Push the value of register R 
DSTSK_STK_PUSHR4 = 4, ! Push the value of register R4 
STSK_STK_PUSHRS = 5, ! Push the value of register R5 
DSTSK_STK_PUSHR = 6, ! Push the value of register R6 
DSTSK_STK_PUSHR = 7, ! Push the value of register R7 
STSK_STK_PUSHR8B = 8, ! Push the value of register R8 
DSTSK_STK_PUSHR9 = 9 ' Push the value of register R9 
DSTSK_STK_PUSHR10 = 16, | Push the value of register R10 
DSTSK_STK_PUSHR11 = 11, ! Push the value of register R11 
DSTSK_STK_PUSHRAP = \¢- ! Push the value of the AP 
DSTSK_STK_PUSHRFP = 135, ! Push the value of the FP 
DSTSK_STK_PUSHRSP = 14, ! Push the value of the SP 
DSTSK_STK_PUSHRPC = 15; ! Push the value of the PC 


! Define the Push Immediate instructions. These instructions are used to push 
' constant values on the Stack Machine stack. The constant value to push comes 
! immediately after the instruction op-code. for the signed and unsigned in- 

! structions, the value to push is zero-exten.ed or sign-extended to 52 bits 

! as appropriate. In the case of the Push Immediate Variable instruction, the 
: eyte after the op-code gives the byte length of the constant value to push. 

! The constant value to push then follows immediately after that length byte. 

! The constant value is zero-extended to the nearest longword boundary on the 
high-address end and the resulting block is pushed onto the stack. 


LITERAL 


DSTSK_STK_PUSHIMB = 16, ! Push Immediate Byte (signed) 
DSTSK_STK_PUSHIMW = 17, ! Push Immediate Word (signed) 
DSTSK_STK_PUSHIML = 18,  ! Push Immediate Longword (signed) 
DSTSK_STK_PUSHIM_VAR = 24,  ! Push Immediate Variable 
DSTSK_STK_PUSHI = 25,  ! Push Immediate Byte Unsigned 
DSTSK_STK_PUSHIMWU = 26; ! Puch Immediate Word Unsigned 


! Define the Push Indirect instructions. for these instructions, the top stack 
' cell is popped ang the one, two, or four bytes at the address given by the 
! popped cell are sign extended to 52 bits and pushed on the stack. for the 


' 
° 
' 
. 
' 
. 
' 
. 
' 
. 
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. 
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. 
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! unsigned instructions, the value is instead zero-extended to 32 bits and 
; pushed on the stack. 


LITERAL 
DSTSK_STK_PUSHINB = 20, ! Push Indirect Byte (signed) 
DSTSK_STK_PUSHINW = 21, ! Push Indirect Word (signed) 
DSTSK_STK_PUSHINL = 6 ! Push Indirect Longword cei gned? 
DSTSK_STK_PUSHINBU = 27,  ! Push Indirect Byte Unsigne 
DSTSK_STK_PUSHINWU = 28; ! Push Indirect Word Unsigned 


: Define the arithmetic and logical instructions. These instruction pop the 
: top two cells on the stack, perform the indicated operation on these operands, 
: and push the result back onto the stack. 


LITERAL 
DSTSK_STK_ADD = 19, Add=--The top two cells on the stack 

are popped from the stack and 
added together. The resulting 
sum is pushed onto the stack. 

Subtract=--The second cell on the stack 
is subtracted from the top cell. 
Both are popped from the stack. 
The resulting difference is then 
pushed onto the stack. 

Multiply=-The top two stack cells are 
popped from the stack and multi- 


DSTSK_STK_SUB = 29, 


DSTSK_STK_MULT = 30, 


lied. The resulting product is 
then pushed onto the stack. 
! Divide--The top stack cell is divided 


' 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
DSTSK_STK_DIV ! 
by the second stack cell. Both 
' 
i 
i 
i 
1 
i 
i 
i 
i 
i 
i 
i 


31, 


are popped from the stack. Their 
quotient is then pushed onto the 


stack. 

Logical Shift--Shift the second stack 
cell by the number of bits given 
by the top stack cell; pop both 
operands and push the shifted 
second cell on the stack 

Rotate--Rotate the second stack cell 
by the number of bits given by 
the top stack cell; pop both 
operands and push the rotated 
second cell on the stack 


DSTSK_STK_LSH 32, 


DSTSK_STK_ROT 33; 


! Define the Copy and Exchange instructions. These instructions make a copy 
of the top stack cell or exchange the top two cells on the stack. 


LITERAL 
DSTSK_STK_COP = 34, ! Copy--A copy of the top stack cell 
} pushed onto the stack 
DSTSK_STK_EXCH = 35; ! Exchange--The top two stack cells are 
: interchanged 


' 
i 
i 
i 
' 
' 
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! Define the Store instructions. Following the op-code, these instructions 
! contain a byte which is interpreted as a signed offset into the stack. The 
! low-order byte, word, or longword of the top stack cell is stored into the 
; byte. word, or longword given by the current stack pointer plus four plus 

! the signed offset into the stack. (In short, the offset is an offset from 
! the second stack cell.) After that, the top stack cell is popped. These 

! instructions permit values to be stored into stack locations other than the 
: top or second stack cell. 

L 


ITERAL 


DSTSK_STK_STO_B = g. ! Store Byte into Stack 
DSTSK_STK_STO_W = 3/7, ' Store Word into Stack 
DSTSK_STK_S10_L = 38; ! Store Longword into Stack 


! Define the Pop instruction. This instruction sinply pops the top stack cell, 
meaning that the top stack cell is removed from the stack and discarded. 


LITERAL 
DSTSK_STK_POP = 39; ! Pop Top Stack Cell 


! Define the Stop instruction. This instruction stops the DST Stack Machine and 
! is required at the end of every DST Stack Machine routine. Whatever value is 
! Left at the top of the stack when the Stop instruction is executed is taken to 
! be the value of the Stack Machine routine. This value may be a longword (a 
: arte address, for example), two sepeueree (byte address and bit offset), any 
' size Literal value (an H-F loating literal, for instance), or a full VAX Stan- 
dard Descriptor, depending on the value of the DSTSB_MS_KIND field. 
LITERAL 

DSTSK_STK_STOP = 23; ! Stop the Stack Machine 


Define the Routine Call instructions. These instructions call a compiler- 
enerated routine (a thunk) whose address is piven by the top stack cell. 
efore the call actually occurs, the top stack cell is peppes. The value 

that is returned by the thunk is then pushed onto the stack. 


The Routine Call instruction works as follows. The address of the thunk to 
to be called is taken from the top stack cell. The =e cell is then popped. 
The thunk, which is called with a CALL instruction, gets two arguments. The 
first argument is the address of a vector of register values for the scope 
(call frame) of the symbol to which this yotus pecification belongs. This 
vector contains the values of req sters RO - R11, ° ° ° and PSL in 
that order; the called thunk is free to read any value it wants from this 
vector but eey not store into it. The second porpaeter is a pointer to the 
‘ie! of the DST Stack Machine stack after the thunk address has been popped. 
A Stack Machine routine ha thus compute arguments to the thunk and push them 
on the stack before pushing the thun address ond calling the thunk. In 
addition, fhe value of FP in the syaber S scope is passed to fhe thunk in 
register R1. The routine's value is expected to be returned in register RO. 
This value is pushed onto the stack. 


The Routine Call With Alternate Returr instruction works this same way except 
that the address of an octaword buffer (4 longwords) is passed to the thunk 


<¢< r- Gg eE 
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! as the first argument, with the register vector being the second argument and 
! the stack address being the third argument. in this cage. the routine value 
: is expected to be returned to the octaword buffer, not in register RO. The 

; whole octaword buffer is then pushed onto the stack. 


LITERAL 
ue returned in RO) 


0, ' Routine Call (val 
1; LL With Alternate Return 


-RTNCALL = 4 
-RTNCALL_ALT = 4 ! Routine Call wW 
Define the Push Record Address instructions. These instructions push the 
address of the outer-most or inner-most record structure for which the cur- 
rent symbol is a record component. aes are used for constructing VAX Stan- 
dard Descriptors on the Stack Machine stack when some part of the descriptor 
depends on some other component of the same record. In PL/I, for instance, 
the subscript bounds of an array component of a record may depend on another 
component of that record. Im such cases, the only way to get the address of 
that other component in the current record is to use one of the Push Record 
Address instructions. The Push Outer Record Address instruction pushes the 
address of the outer-most record of which the current iy: is a component 
while the Push Inner Record Address instruction pushes the address of the 
inner-most record of which the current symbol is a component. 


ITERAL 
DSTSK_STK_PUSH_OUTER_REC = ¢g: ! Push Outer Record Address 
DSTSK_STK_PUSH_INNER_REC = 43; ! Push Inner Record Address 


ee ee ee ee ee 


! Define the highest op-code value accepted by the DST Stack Machine. This 
: value is used for op=-code range checking. 


LITERAL 
DSTSK_STK_HIGH = 43; =! Upper bound for range checking 


! END OF VALUE SPECIFICATION DESCRIPTION. 
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TRE FTVPE SPECT RP CEATISCO€’ OST BECERS 


The Type Specification DST record gives the most general data type 
description available in the Doous Symbol Table. It contains the 
name of the data type being described se a DST Type Specification 
that describes the type. The type name is used in languages where 
data 1r°s can be named, such as PASCAL. If no type name exists, 
the null name (the name of zero Length) is specified in this record. 
DST Type Specifications are described in detail in the next section 
of this definition file. 


Type Specification DST records either immediately follow Separate 
Type Specification DST records or are pointed to by Indirect Type 
Spec ty ications or Novel Length Type Specifications elsewhere in 
the DST for the current module. 


This is the format of the Type Specification DST record: 


' 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
' 
i 
i 
i 
i 
i 
i 
i 
i 
i 
' frwmoe semen oe mono me were nwo ne mee me en nm mm eee een ww sree een nner em nm nanos e + 
' 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
' 
i 
i 
i 
i 
i 
F 


+e eecoeoe Sr eee sneer eee eS See an ee os co ww er ener ese mr me eee e een m ee eos eeceonreeee + 
byte DSTSB_LENGTH H 
byte DSTSB_TYPE (= DSTSK_TYPSPEC) H 
byte ‘ DST$B_TYPSPEC_NAME H 
var H H 
The Type Name in ASCII 
(The name's Length is given by DSTSB_TYPSPEC_NAME) 
é eecoeece eee ere e nt eee eee OPO SS 8 SSS 6 SSO SSS SSS SSS SSSSSSSSSSSSSSOSSSOSSOS + 
var ' DSTSA_TYPSPEC_TS_ADDR 
The DST Type Specification for the 
Data Type being defined 
eae eeececee OOS OS OS OS OOS SSS SSS SSS SSS SSSSSSSSSSSSSSSSSSSSSSSSSSSe ’ 
Define the fields of the Type Specification DST record. 
IELD DSTSTYPSPEC_FIELDS = 


SE 

DSTS$B_TYPSPEC_NAME =({€ 2,686.1], 
DSTSA_TYPSPEC_TS_ADDR =([( 3, A_ J] 
TES; 


The count byte for the Counted 
ASCII Type N 


ame 
The location of the DST Type 
Specification 


F 
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word 
byte 


var 


DST TYPE SPECIFICATIONS 


A DST Type ag bes ba speci ties the data type of some data symbol. 
DST Type Specificat constitute pe pnpet eneral form of data ype 
Soret pt ion available n the Debu Aimy able. They gre e found 
only one kind of DST record, name he BL. Specification DST r cord. 
However, some Type Specifications Zont in nested plype Specit cations, 
they permits quite complex type pea tions. For example, the parent 
type for a Subrange data type 13 9 wyen y a nested Type Specification 
within the Subrange Type Specification. 


This is the general format of all DST Type Specifications: 


Zero or More Other Fields Depending on DST$B_TS_KIND 


} cocccccccs % = > 


a 
8 
‘ 
u 
a 
‘ 
a 
y 
a 
6 
e 
6 
t 
a 
e 
a 
] 
i 
t 
t 
t 
i 
t 
a 
a 
g 
‘ 
a 
Q 
€ 
a 
5 
a 
a 
a 
‘ 
0 
o 
u 
8 
t 
t 
a 
o 
f 
7) 
‘ 
f 
t 
1 
$ 
g 
a 
é 
t 
£ 
6 
5 
i 
4 
t 
' 
a 
a 


ata symbol whose pete type must be described by a DST Type Specifi- 
ion is described 7? Separate Type Specification DST record. This 
record is immediately followed ype Specification DST record 

ch contains the DST Type Speciticat on for the symbol's data type. 


To conserve DST space when several symbols have the same data type the 
Type spect rseesten that follows the Separate Type $ oc i teas ion sf 
record my AR an Indirect Type Spec it icat on. The Indirect Type Speci- 
fication then Conse ns —X. ifs po oe fe the ocruee Type Spe s cat " 
DST record for 2 9 s type. ony : single copy of this actual 
Type Specificat ~ $s oi needed. Multiple Syapors of ites eons Record 
or enumeration ype must gies, se Sep parate Type Specifi cot on 
focerse fort y Type Spe ification DST records conta ning St irect 
Type Specifications. ‘s case, the Indirect Type Specif cet ons 
nt to the secere Begin. hi numeration Type Begin DST record for the 
Pecord or enumeration type being specified. 


In fect. the . i etn Spec tf icot ten ctf can refer. te a@ record or enum- 
grate i” p tyee ts he Ind girest Type Specification. he Nove) iene Type 
on $s no Hs 4 norastly used thi sy ay 

spect Hicoed : e"ehus used within igtner ty pe Specific * ay og A record 
- enumeration Ss must -. spect ier examp @. iwnen the ol 

type of an oes H ’ record reenunerat {on type. ss spec} ied by i 
rs rect Type Specif . tion within the nerey ype spec fication : 
arly, itt he target 0 ? typed geigter | 5% rycore or enumeration tp 
object, the target type is specified by an ind rect Type Specificat hy 


_" 
@ 
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within the Typed Pointer Type Specification. 


' 
! 
' 
i 
i Define all the fields that can appear in the various Type Specifications. 
Also define the declaration ecto. ~ 
f 


IELD DSTSTYPE_SPEC_FIELDS = 


DSTSW_TS_LENGTH ={0,u_], The bengeh of the Type 
hell fication nor H + laa 
ng this bengeh tf 
DST$B_TS_KIND = » B. de The T pe Speci cation k 
DSTSB_TS_ATOM_TYP = » ©. de The Atomic data type Bag 
DSTSA_TS_DSC_QSPEC_ADDR = > oe The VAX descr pror Value Spec 
DSTSL_TS_IND PTR - o ha. de Indirect Type Spec DST pointer 
DSTSA_TS_TPTR_TSPEC_ADDR= » &, te Typed, Poi > ser cat ton type Type 
apes) ion location 
DSTSB_TS_PIC_DLENG et 3, &. 3. he byte lenges of data sbjects 
of this picture type 
DST$B_TS_PIC_LANG =(4, 6.1], The DST Language code for this 
picture data 25 ae 
DSTSB_TS_PIC_PLENG =(€5, 6.1], The Longsh of the pic 
string in this Type. Spec 
DSTSA_TS_PIC_ADDR ={€6,A_], The location whore the picture 
is encoded i Type Spec 
DSTSB_TS_ARRAY_DIM f 3, 8B. }° The number of orrey dimensions 
DSTSA_TS_ARRAY_FLAGS_ ADDR= 4, A], The location of the array flags 


shot indicate Type Specs 
for phe - Sepecr igs attees 


DSTSL_TS_SET_LENG e€ 3 &.. de The lsbfects 
°¢ ts. of ENS, set 
DSTSA_TS_SET_PAR_TSPEC_ADDR = [ 7, A_ J,! The location = 
perent. "ype ty Sp 
DST$L_TS_SUBR_LENG ef & t 3 The Length in of r) ts 


of this subrange t a 
eee of rte gerent 
fication : thin 
: ; * range ype Spec 


DSTSA_TS_SUBR_PAR_TSPEC_ADDR= ( 7, A_ J, 


DST$B_TS_FILE_LANG 4%. » }: Language code for f type 
DSTSA_TS_FILE_RCRD_TYP 4, A], aa ¢- of . 74 $ ae ¢ giving 
men e 
DSTSA_TS_AREA_BYTE LEN = »& de Length —. tes ot PL/I “area 
DSTSA_ 1s “OFFSET_VACSPEC = E 3: AL }: Location” spytet lue Spec giving 
ase pApress of PL/I area 
DSTSL_TS_NOV_LENG et & b. Be The ' qooe ength in bits of 
novel | ofe this. data type 
DSTSL_TS_NOV_LENG_PAR_TSPEC = C 7, L_ J,! DST pointer. t to ef Lengent or 
$s en e 
DSTSL_TS_SELF_LENG =(€3,t.] Table length. this ray of 


EE EE EE EE EEE EEE OEE EEE EEE ES ee ae 


PL/I SelfcRetat ve ts els 
TES; 


DSTSTYPE_SPEC = BLOCKC,BYTE) FIELD(DSTSTYPE_SPEC_FIELDS) 2%; 


st 
@ 
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: The following are the values that may appear in the DSTSB_TS_KIND field. 


LITERAL 
DST$K_TS_DTYPE_LOWEST 
DSTSK-TS_ATOM ~ 
DST$K-TS_DSC 
DSTSK-TS_IND 
DSTSK-TS_TPTR 
DSTSK-TS_PTR 
DSTSK-TS_PIC 
DSTSK-TS ARRAY 
DSTSK-TS_SET 
DSTSK_TS~SUBRANGE 
DSTSK_TS_FILE 
DSTSK-TS_AREA 
DSTSK—-TS_OF FSET 
DSTSK~TS_NOV_LENG 
DST$K~TS~IND~TSPEC 
DSTSK_TS_SELF_REL_LABEL 
DSTSK-TS_RFA ~ 
DSTSK-TS_TASK 
DST$K-TS~DTYPE_HIGHEST 


! The following set of Literals 
; Specifications which have a fi 


LITERAL 


DSTSK_TS_ATOM_LENG 
DST$K_TS_IND_CENG 
DST$K_TS_PTR-LENG 
DSTSK_TS_FILE_LENG 
DSTSK_TS_AREA"LENG 
DSTSK_TS_OFFSET LENG 
DSTSK_TS_NOV_LERG LENG 
DSTSK_TS_ “TAS LENG 


xed 


WNW 


aaa tt I OOVNOU SW SS 


CONO USEWR Oe + es se se se ees 


eee 8 © 


—e © 8 © 8 8 


*e © 8 & & 


---Lowest hig e ae kind 
Atomic Typ pes 
VAX Standard ww Type Spec 
qneiroct Type 
typed Pointer <iype Spec 
nter T aay ec 
Pictured pec 
Arra tes Spec 


Offset ype Spec (PL/I) 

Novel \ense pe Spec 

wae nternally generated pointe 
fs Spec (cannot appear 10 in 

sel t-Re tive Label Type Spec (P 

Record File Address Type Spec (B 

Task Type Spec (ADA) 

=---Highest Type Spec kind 


Pd 


oreo one is lengths in bytes of those Type 


Atomic Ty ype Spec length 
Indirect Type Spec length 
Pointer Type Spec length 

File Type Spec Length 

Area Type Spec length 

Offset Type Spec Length 

Novel Length Type sore Length 
Task Type Spec length 
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word 
byte 
byte 


word 
byte 
var 


ATOMIC TYPE SPECIFICATIONS 


The Atomic Type Specification is used to describe an atomic VAX standard 
is ype Specification consists of the standard Type Speci- 

ication header followed by a ngte byte centetntes the VAX standard 
The Atomic Type Speci- 


dete type. 


data type code (one of the DSCSK 


TYPE_x codes). 
fication has the following format: 


fetes aces sone e s“eeecee SOS SSS SSS SSS SSSSSSSSSSSSSSSSESSESES22 eeceeeeceeoan$ 


' DSTSW_TS_LENGTH (= 2) i 


dere e eens tr eee eee ee tee ee ete ewe eee wer ee eo ew eeewmsenoceoocan eeeeaeoe eed 


DSTSB_TS_KIND (= DSTSK_TS_ATOM) 


gemma mer near oanm arene enn creer oe woe meee ncecae eeeeoeoeoeooeoe weenraesenasawe + 


DST$B_TS_ATOM_T(P 


$ een ceo oremoewoururermoe ser aerecnrecacs eooeecee@ eeeeecoeeo See eee eee eeeeeneeoeoeoaneanoe + 


DESCRIPTOR TYPE SPECIFICATIONS 


The Descriptor Type Specification is used for VAX Standard Data Types 
e- 


that can be described by VAX Standard Descriptors but cannot be d 
scribed by an atomic type code. Packed decimal, which requires a 
digit length and a scale factor, and ASCII text, which requires a 


pel Bes nae are examples of such data types. The Descriptor Type 
c 


spect ation contains a Value Specification which must produce a 
VAX Standard Descriptor. This is the format: 


poe reste eee een em esos eee ewe meee eee RS eee Oe SS POOR Sem SR mm + 


DSTS$W_TS_LENGTH 


ese see ee oee eee eee ee ese see eee ee Sees essere ese sees sees esse Bee ee + 


: DSTSB_TS_KIND (= DSTSK_TS_DSC) H 


pm non emer ose em necr one com oa een eee mmo eEowownren eeeeeee eSeeee es eoeeee oa 


DSTSA_TS_DSC_VSPEC_ADDR 
Value Specification Yielding a VAX Standard Descriptor 


See eee eee eee eeeeeo Seen wrasse ear eee ee eee eee eS eee eee eee sre tee wecce+ 
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INDIRECT TYPE SPECIFICATIONS 


The tneicoct Type qund. in gnothe is used when the ac pues Type Soect ica- 


tion qes' red B nether DST record. pase pe Spec cat on 
cents ns a Sst* A. = * ch points to that other DS re ord. 
pointer contains the byte offset hy ed i to the star the ubet e DST 


of the DST record that gives the actyel type nformat on. ‘es pointed- 
to DST record must be one of cares kinds of DST poceres a ype Speci- 
fication DST record, a Record Begin DST record, or an Eruner tt on Type 
Begin DST record. fhe In rect type Specification the only Type 
moby cation that can = er to a record or enumeration type; those 
types are too complex (potentially) to be referred to any other way. 
This is the format of the Indirect Type Specification: 


brewer econ ete wc ese ern e rece moe ecm ecw eanome sSeeeeeoe Senne wowace neaae $ 


' DSTSW_TS_LENGTH (= 5) ' 


$6SeeOeeeeseeeseeensreseeaSsesseeeuseuseseuseuasseueseeoseeesece + 


' DSTSB_TS_KIND (= DSTSK_ TS. IND) i 


town anocce eeeoeeoeoeoeoe Quenebandeaeseee See ee e222 2222222202 See eee eeeeeneneaeae a 


DSTSL_TS_IND_PTR 
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word 
byte 


var 


word 
byte 
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TYPED POINTER TYPE SPECIFICATIONS 


type. meaning a pointer to a specific other data type. Pointer-to- 
nteger, as found in teoeny and other fanguage - 18 an example of a 
type pointer ty e. In this nteger_ is the ‘parent type'’. 
This Type Specification contains an cmpoeeye Type Specification which 
specifies the parent type for the typed pointer type. This is the 
format of the Type Pointer Type Specification: 


eee e eet es eee nn een een ee eT EeePC Se CN BO ROMO BEE Ee TOE ae eeeeoeeeaoe weoen + 


Be oS 
: DSTSB_TS_KIKD (= DSTSK_TS_TPTR) } 

DSTSA_TS_TPTR_TSPEC_ADDR H 
Type Specification for Parent Type that 


Objects of Typed Pointer Type Point to 


} cece ce cocccecs 


POINTER TYPE SPECIFICATIONS 


The Pointer Type Specification is used for pointer types which are not 
typed, meaning that the type of object that the pointer points to is 
not known at cone “time. PL/I peceters are examples of this kind of 
pointer type. Since there is no known parent type, none is specified 
in this Type Specification. The Pointer Type Specification thus has 
the simplest possible format: 


gem weer rw emo reer me on ee eer Teese wees BD e cee ee Se S22 222222 SS 2 e2e2eeeeeee + 


DST$W_TS_LENGTH (= 1) 


torocer ent enwreceoeem owen en aawoare (63 Se Ge eo Ga mE ee on Se ee me en ee ar ee me cn ee ee ee a ee ee ee sSeeeeeooeen weet 


DST$B_TS_KIND (= DSTS$K_TS_PTR) 


Few rete wen ene em ene emer ne mem se mew nmr ome men w ene BO mw Eee eee ew ee eo 
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word 
byte 
byte 
byte 
byte 
var 


var 


PICTURE TYPE SPECIF 


ICATIONS 
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The Picture "apy, Shes reas tes is used for picture data types as found 


in COBOL and 
vary between Langua 
code associated wit 
byte length of obje 
and a language-spec 
string). The actua 
to be represented a 


Because the exact 


l data objects of t 


C b objec encodi 
s ASCII character s 


semantic 


s of picture data types 


ges this Type Specification contains the language 
this specific picture type. It also contains the 
sts of the picture type, an encoding of Ene picture, 


ng (usua 
he of 
trings. 


lly the C pattern 


cture data type are assumed 


This is the format of the Picture Type Specification: 


bomen ce 8 ee a ea 


eee 


DSTSW_TS_LENGTH 


DST$B_TS_KIND (= DSTSK_TS_PIC) 


+ eeeee] SSS SSS SSS SSSSSSSSVSSSSSSSSSSSSSSSSSSSISISISVBSOSOSQSO See wore enewcere$ 


DST$B_TS_PIC_DL 


ENG 


$m eran men men enwae SSS nserowrooe wet eeener ene ete e eee sree esa n ceo seme o een + 


DSTSB_TS_PIC_LANG 


$e een oaene S228 S222 22222 22222222822 S22 Se eee eeeeeoeeneeo 


DSTSB_TS_PIC_PL 


ENG 


DST$A_TS_PIC_ADDR 


Value Specification Yielding a 
Language-Specific Encoding of Picture Semantics 
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Picture String En 


coding 


The DSTSB_TS_PIC_DLENG field contains the len 
object of this picture type. DEBUG as 
represented internally as ASCII character strings. 


The language code in the DST$B_TS_PIC_LANG field is the same as that 
used in the Module Begin DST record. 


The DST$B_TS_PIC_PLENG field 


encoding In the BST$SA_TS_PIC Rook fiel 
PIC 7 


DSTSA_T 
order byte of each 
the low-order byte 
picture character. 


ADDR field Tons 
word 


ts of a 


contains the ASCII 
Hence the picture 


ontains an uns 


sumes ch 


ned r 


$559.99. 


sionea'¢ 


cree nn me en nn } on ween nn ne } = =e 


th in bytes of each data 
at picture objects are 


ives the byte length of the picture 
d. The 


picture encoding in the 
of words. The high- 
epes ition factor and 
tation of the repeated 
is represented by this 
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uence of byte yalues: ‘'S'’ “s «le Se Oe (The Gene 
p picture con be uritten as 55t3)6, (gr § 


The o etonet Value sbadress.of fh +t the end of the Picture Type Speci- 
sicet on yields Lin sesrors unis p DITPC +> sage ete an9 tha per orms 
the enc ine assoc! ated ot cture Ut ienk e ys es th pattern 
string with the EDIT instruct on : 9 +4 g SEPOSITS in nto objects of 
this t ttere sys. 3 the Value Specification is omitted, DEBUG can 
only deposit character strings into such objects since it does not know 
how to encode numeric values. 


TB 


| 
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ARRAY TYPE SPECIFICATIONS 


The Array Type Spec it tcatton apeesvsee an Array data type. This speci- 
fication can be guite complex because it not only specifies the shape of 
each array of this type, but also specifies the correspond ng element 
data type and all subscript data types. The element type and the types 
of the subscripts are given y additional Type Specifications nested 
within the Array Type Specification. 


This is the format of the Array Type Specification: 


: ! 
{ t 
7. 
; ' 
' 
i 
i : 
i 
i ' 
i ioenieonenetibadieeieitieniereutiiqnnenineniniiddammdianaiaiaratinie i 
word : DSTSW_TS_LENGTH H : 
byte i DSTSB_TS_KIND (= DSTSK_TS_ARRAY) H : 
byte } DST$B_TS_ARRAY_DIM ! 
var} DST$A_TS_ARRAY_FLAGS_ADDR } 
Bit Vector of Flags Indicating What Type 
! Specifications are Given Below : 
(The vector's bit Length is given by DST$B_TS_ARRAY_DIM) } 
ark ! 
i ee weeeee eee ee eee ee eee e ewe wn wwe wn nnn nnn n ene n none ee ee-e- + : 
! var H H . 
Value Specification Producing an Array Descriptor 
S saaapdiesetiaindibalianniieaaidnedtei enisiiehsiahindaicaietiiabiaiiemninas ; 
! var ' H . 
: ‘ Optional Type Specification for Array Element Data Type ' : 
i ' 
i amen ermine pumcimnannativs seeeaninemiaonmeentin : i 
! var H ' : 
‘ Optional Type Specification for First Subscript Data Type : 
i $ceccsceescesssnssessssceceenses owsnweus POnGUENESETESESEEEEEENES + 
por i 
More Optional Type Specifications for Subscript Data Types 
i H ' i 
i H H i 
; Taioteiiiihiiainindininieeminicea @eeeoeoeeoe2 See 2@e2e2ee222O222222222 Seeeeeeeoeeee20220 + ' 
1 

i 

i 

i 


Here the DST$B_TS_ARRAY_DIM field gives the number of dimensions of this 
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array type. Next, DSTSA_TS_ARRAY_FLAGS_ADDR gives the location of a 
bit-vector which indicates wha weeres Type pgec fications are foun 
later in this Array Type Specification. If bit 0 is set, a nested Type 
Specification is included for the ercey element type (the cell type). 
After that, if bit n is set, a nested Type Specif sation for the n-th 
rere et type is included in this Array Type Specification. If a bit 
in the bit-vector is zero (not set), the Serreqponetng sype Specifica- 
tion is omitted from the Array Type Specification. If the element type 
specification is omitted, the element type is assumed to be given by the 
ercer descriptor's DTYPE field. If a su g oy o type spect? icas ion 5 
omitted, the subscript type is assumed to be longword integer (DTYPE_L). 
(Subscript Type Specifications are mainly needed for enumeration type 
subscripts as allowed in PASCAL.) 


The number of bits in the bit-vector is DST$B_TS_ARRAY_DIM plus one more 
for the element type. The whole DSTSA_TS_ARRAY_FLAGS_ADDR field is of 
course rounded up to the nearest byte Boundary. 


The array descriptor Value Specification that follows the bit-vector 
field produces a VAX Standard Descriptor for the errer- (The descriptor 
class must be DSCSK_CLASS_A, DSCSK_CLASS_NCA, or DSCS$K_CLASS_UBA.) This 
array descriptor gives the strides (or multipliers) and the Tower and 
upper bounds for all of the array dimensions. It also gives the element 
data type, including its scale factor, digit count, or other type infor- 
mation as appropriate. However, the descriptor's element "— can be 
overridden y an element Type Specification as noted above; in this case 
the DSCSB_DTYPE field of the descriptor should be zero. 


The Array Type Specification is normally only used in two situations. 
First, it is used if the array fype does not have a compile-time-con- 
stant descriptor (for example, if it has variable array bounds) and no 
run-time descriptor exists in the user's address space. Second, it is 
used if the oreey type cannot be described a VAX Standard Descriptor, 
either because the element type cannot be described by a VAX Standard 
Descriptor or because the subscript types are not integers. (Element 
types such as records, enumeration types, and Fyped pointers cannot be 
described by VAX Standard Descriptors.) If neither of these situations 
pertains, there are simpler ways of describing array types in the DST 
using Standard Data or 


Oe ee ee 


escriptor Format DST records. 


' 
i 
i 
i 
i 
i 
' 
' 
' 
i 
i 
i 


TBr 
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SET TYPE SPECIFICATIONS MAC 


The Set Type Specification specifies a Set data type as in PASCAL. A 
Set type a oe * has a parent data type. For the set-of-integers type 
for example, integer MY the parent ‘ype. The parent type must be either 
integer, some enumeration type, or a puarenee of those Haatt DEBUG 
assumes that the Set type is roproseniye internally as a bit-string 
where a given bit is set if and only if the correspenein integer or 
enumeration type element is a member of the set. [The n-th bit of the 
bit-string (starting at bit 0) is assumed to cerrvepeng to the n-th 
element of the parent type. The length of the bit-string is part of 
the Set type and is specified in the Set Type Specification. 


This is the format of the Set Type Specification: t 

t 
$eewnwwweononenne woe wooonnne woewoowoone ween ccecenose cone eeese + 
ate BU linen NaS mater AE RTI To ; 
tage PERSE we ha bb ane an bee Eine Ae all ae ; 
PN ae ek ad ee | Seg Serie ti ccwciiiaiotaceuliibidieia ; 
var i DSTSA_TS_SET_PAR_TSPEC_ADDR 
Type Specification Specifying the Set's Parent Type 
ckienoeiibsngbiuaeiulsiisamaens condones Seinllessiehiihliiotsiaetaiaiainsitinies : 


Here the DSTSL_TS_SET_LENG field gives the bit length of an object of 
the Set data type. DSTSA_TS_SET_PAR_TSPEC_ADDR marks the location of 


an embedded DST Type Specification for the parent type of the Set type. 


Typically this is an Atomic Type Specification for Lad integer, an 
Indirect Type Specification that points to an Enumeration Type Begin 
DST record, or a Subrange Type Specification. 


' 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
; 
' $m mm wee eee Ben eee moe 
i 
i 
i 
i] 
i 
i 
i 
i 
i 
i 
i 
i 
i 
' 
i 
i 


Dd 
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i word 
i byte 
i long 
{var 


: var 


. var 


SUBRANGE TYPE SPECIFICATIONS 


The Subrange Type ye he ge describes a Subrange data type, meaning 
a subrange of sone ordinal type such as integer or an enumeration t pe 
ms , "ype Spec ees on specifies the gerent type (the original ord nal 
type? and the lower and upper bounds of the subrange. It also gives the 
bit length of objects of the Subrange type. This is the format of the 
Subrange Type Specification: 


tence ae wen er sear scene enn eee samme See OSE Mew me oo woe ame oe ee + 


! DSTSW_ TS_LENGTH H 
! “DSTSB. TS “KIND (= DSTSK_TS ~ SUBRANGE) H 
DSTSL_ TS_SUBR_LENG i 


DSTSA.  * SUBR_ PAR_TSPEC “ADDR 
Type Specification Specifying the Subrange's Parent Type 


Here the DSTS$L_TS_SUBR_LENG field ives the Length in bits of wbjests 
of the SuDrengs data ty Lg S_SUBR_PAR_TSPEC_ADDR marks the 
location of a Type peci iPestrosct for the parent type of the sub- 
range. Typically this is an ead Type Specification for ty ype sateger 
or an ed | rect Type Specification pointing to an Enumeration Type Begin 
OST record. 

The two Value Specifications in this Type Specification specify the 
lower and upper bounds of the subrange. These bounds values must be 
values of the parent type. 


' 
A] 
' 
' 
i 
i 
F 
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FILE TYPE SPECIFICATIONS 


Here the DSTS$B_TS_FILE_LANG field contains the Language code for this 

file. The same language codes are used as in the Module Begin DST 

record. DSTSA_TS_FILE_RCRD_TYP is the location of a DST Type ag ae 
cation is 


' 

' 

: 

' The Fils "eps Specification sag 5 bd a File data type as found in 

' PASCAL or PL/I, for example. Since the interpretation of File types 
: varies from Lanquege to language, phe language code for this File 

’ type is included in the Type Specification, Optionally, a file record 
: Type Sorc tticatton can be included speci tying the type of a record in 
: this file type. A PASCAL File-of-Reals, for instance, would have Real 
: (F-Floating) as its file record type. 

! This is the format of the File Type Specification: 

i teem acon See eeeeeeeeeeeen eeneonenn SON BOSE EDO EcEeeaneaem te weeeanac ee + 

: word } DST$W_TS_LENGTH H 

; byte | DST$B_TS_KIND (= DSTSK_TS_FILE) i 
byte DST$B_TS_FILE_LANG ' 

} var} DST$A_TS_FILE_RCRD_TYP 
Type Specification Giving the File Record Type | 
pees ! 

i per wem creer ene mer sree see ees en eowen srr eee eon em eee ere meme meme mone nee oe + 

1 

i 

i 

i 

i 

i 

! 


cation for the record type. if applicable. This Type Spec 


optional; if omitted, file-of-characters is assumed. 


F 
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4 
fe] 


AREA TYPE SPECIFICATIONS 


NOTE: THIS TYPE SPECIFICATION IS NOT SUPPORTED BY DEBUG V4.0. 


The Area Type Specification describes a PL/I ‘‘area'’ type. PL/I areas 
are regions of memory whose base addresses are determined at run-time. 
Areas are always used in conjunction with PL/I Offsets (see below). 
This is the format of the Area Type Specification: 


] 

i 

i 

i 

i 

i 

i 

i 

i 

i 

i 

i 

' ee eee eee e Se ee 2 eee Bee Se S&H & we Oe ee = wee twos soe mar en ere nem e reese eecm een a} 
: word ‘ DST$W_TS_LENGTH 

i 
i 
i 
i 
i 
] 
i 
' 
i 
' 
' 


byte | DSTSB_TS_KIND (= DSTSK_TS_AREA) 
DSTSA_TS_AREA_BYTE_LEN 
Value Specification Giving the Area Byte Length 


var 


$ ocecwcecon <= } -e 


on on on nn > 


Here the DSTSA_TS_AREA_BYTE_LEN Value Specification specifies the byte 
Length of the PL/T Area. 


! 
i 
i 
i 
' 
f 


“4 
ow 
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OFFSET TYPE SPECIFICATIONS 


| 


NOTE: THIS TYPE SPECIFICATION IS NOT SUPPORTED BY DEBUG V4.0. 


The Offset Type Specification describes a PL/I ‘‘offset’’ type. PL/I 
offsets are offsets relative to the start of a PL/I ‘‘area’’ (see above), 
a dynamically allocated rare of memory. The Offset Type Specifica- 
tion specifies the base address of the associated area and the byte 
offset value of this offset type. This is the format: 


es eee eee eo eee e2ee2 ee wrernrc erro er wm e® wt we eererrwr@teeeceewtoeoe ecw ewe eee emew emer eer ween = + 


word Hl DSTSW_TS_LENGTH H 
byte H DSTSB_TS_KIND (= DSTSK_TS_OFFSET) H 
i DSTSA_TS_OFFSET_VALSPEC 
Value Specification Giving the Base Address 
of the Area Associated with this Offset 
toceecenennncnnn= eowecnnnnnnnenecnenennnnnnnnnnnnnnnnne= a 
var H H 
Value Specification Giving the Byte Offset Value 
Ponernneneeeereneennenesenenennnewessnnsrceceeemneee eemnennennnnt 
Here the DSTSA_TS_OFFSET_VALSPEC Value Specification produces the base 


address of the asSociated area and the second Value Specification gives 


' 
i 
i 
i 
i 
i 
i 
i 
' 
i 
i 
i 
i 
' 
i 
' 
: var 
‘ 
i 
i 
i 
i 
i 
i 
i 
' 
i 
' 
i 
i 
i 
i 
i 
i 
: the byte offset value into the area. 


! 
i 
' 
i 
F 


H 
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word 
byte 
long 
Long 


NOVEL LENGTH TYPE SPECIFICATIONS 


The Novel Length Type Specification is used to s oc tty - data type 
that is identical to @ parent data type except that the objects of this 
new type hove a different length (a “novel” or atypical Length). This 
ree pecification is used for the components of PACKED records in 
PASCAL, for example. A boolean component of a peckse record cong iste 

of a single bit (the novel Length) while all other booleans consist of 

a byte (the normal sone» To describe the pecked yootesn type, a 
Novel Length ye Spec fication is used which specifies the novel Length 
and points to the DST description of the parent type. namely the normal 
boolean type. DEBUG accessed objects of a Novel-Length type by expand- 
ing them to the normal length for that type. 


This is the format of the Novel Length Type Specification: 


H DSTSB_TS_KIND (= DSTSK_TS_NOV_LENG) i 


te eeeeoe Seeeeeoeoeoeoee eewrererrreweer eee ereeoeeaeoeereoe~. = eSeeeeeaeenee eSeeeoeoaoenoeeae ea 


i DSTSL_TS_NOV_LENG i 


Feo nae ooeeceoe eereernrerrerreecrnco= SSeS eee eeee eee eeoeoeeoaanea Se ee eeenoeeaeaeeo eet 


wees os oe nes eon ee mera aren anaes $ 


Here the DSTSL_TS_NOV_LENG field contains the "novel" Length of this 
data type. The DSTSL_TS_NOV_LENG_PAR_TSPEC field is a DST pointer which 
contains the byte offset relative to the start of the whole DST of the 
DST record that specifies the perens type. The pointed-to DST record 
must be a Type Specification DST record, a Record Begin DST record, or 
an Enumeration Type Begin DST record. (Typically it is a Type Specifi- 
cation DST record containing an Atomic Type Specification for type inte- 
ger or boolean or an Enumeration Type Begin DST record.) 
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word 
byte 


word 
byte 


SELF-RELATIVE LABEL TYPE SPECIFICATIONS 


The Self-Relative Label Type Specification specifies the type of a PL/I 
self-relative’’ label. Such a label is actually a Label array. meaning 
that it must be indexed by an integer value to yield a specific label 
value. The internal representation consists of an array of longwords 
where each array element contains a label value relative to the start of 
the array. Making the ehenent values relative to the start of the array 
ensures that the label array is Position-Independent (PIC). 


This is the format of the Self-Relative Label Type Specification: 


poser eon e crewmen ecm ese nee mere eee me mem eee wer wows cmecrcaca eseeeeceoe oon 


DSTSW_TS_LENGTH (= 1) 


+ eooeecee wnTeeewrernetreewrowrmeeewr eee ete ee = weer ee eer foe eter eoecece swe ae eww eee ee} 


DST$B_TS_KIND (= DSTSK_TS_SELF_REL_LABEL) 


tone eee ee ee eeeeo OSS S SSS SSSSSSSSSSSSSSSSSSSSSSSSSSSSSOSOSISSSSSSS2S2SS + 


TASK TYPE SPECIFICATIONS 


NOTE: THIS TYPE SPECIFICATION IS NOT SUPPORTED BY DEBUG V4.0. 


The Task Type Specification specifies the data type of task objects 
as found in ADA. Objects of the Task data type are assumed to have 
longword values understood by the ADA multi-tasking kernel. Since 
no additional information is associated with the Task data type, the 
Task Type Specification has the minimal format: 


pee ee eosce wcrc See ee e222 2222222202 SS SS SSSSSSSSSSSSSSSSSSS SSS 22222 woot 


“DSTSW_TS_LENGTH (= 1) 


goer ocean neem erm ese wenn enor mew mn een ee cewa weer oe ee www ee eee BDO eo ee + 


DST$B_TS_KIND (= DSTSK_TS_TASK) 


i END OF TYPE SPECIFICATION DESCRIPTION. 


_" 
mn 


K 
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THE ENUMERATION TYPE BEGIN DST RECORD 


The Enumeration Type Begin DST record specifies the name of an 
enumeretion type and the bit length of objects of that type. 

It also serves as the apening bracket for a list of Enumeration 
Type Element DST records, and must be mpeenee by a closing 


Enumeration Type End DST record. This is record's format: 


+ eeececee Tew wow B BE Me BeBe wee Been wee OBS HME ee MEN SEBO HOSE ew eet ase aneas } 


byte } DSTSB_LENGTH 


pesos e ses ee eee es see eon ee Oe eee DEO MeE Bese esoeescowen eases oaasae eeoeee a 


byte i DSTSB_TYPE (= DSTSK_ENUMBEG) ' 


emer me renee mw meee ewe we eee nee ee wee eee ee ewe eee nw ew ee ee meme ew ewe mene wee} 


byte i DSTS$B8_ENUMBEG_LENG i 


' 
i 
' 
i] 
' 
'‘ 
7 


byte i DSTSB_ENUMBEG_NAME ' 


Few ooeeeeoeeoeeeeoesoesesess Seoeeeoooeesoessseeessees eocoveeesseoe+ 
var ' 
The Name of the Enumeration Type in ASCII 


(The name's Length is given by DST$B_ENUMBEG_NAME) 


Define the fields of the Enumeration Type Begin DST record. 

IELD OS TOEMUNBES_F SELDS = 
DST$B_ENUMBEG_LENG =C{€2,6_.], 
DST$B_ENUMBEG_NAME =C( 3, B 3 
TES; 


Bit tongth of data objects of 
this enumeration type 

Count ort? for the Counted 
ASCII Type Name 


4 
m 
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THE ENUMERATION TYPE ELEMENT DST RECORD 


The Enumeration Type bees DST record specifies the name and value 
of one element (one | sores? of an enumeration type. It may only 

ap ear between an Enumeration Type Begin and an Enumeration Type End 

DST record. The underlying representation of enumeration types is 
assumed to be unsigned integer. The DSTSB_VFLAGS field in s record 
has its normal interpretation (see the syenger Data DST record for 
the details). Hence the DSTSV_VALKIND field will have the value 
DSTSK_VALKIND_LITERAL and the BSTSL_VALUE field will have the appro- 
priate integer value in this case. 


This is the format of the Enumeration Type Element DST record: 


cana RN CNARIRERIRANL ——T" — Lemmanneaeeaaeea | 
chee OE ian Bol iN es EE, 
he, ETS PAM ee am = te SS mend Law ; 
ied sniasnatals A a ee ae ; 
ane piotedieaniel EL i ann. AO Satta A A Sl 
ad The Name of the Enumeration Literal in ASCII ! 

(The name's length is given by DST$B_NAME) 

incheesunpdneaanins seicanintinns snaivehinannceneianan secsiiemnponians : 


THE ENUMERATION TYPE END DST RECORD 


The Enumeration Type End DST record terminates the description of an 


! 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
1 
i 
i 
i 
i 
i 
' 
i 
i 
i 
1 
i 
i 
i 
i 
i 
i 
i 
1 
i 
i 
i 
i 
i 
i 
i 
i] 
i 
i 
i 
enumeration type. This is the record's format: 
i 

i 

i 

i 

i 


¢ wee weer ete e se eee ee Beem e ee meme See eoeeeoeeeeeeoesesesssesc= ecoceet 
byte} DST$B_LENGTH : 
byte | DSTSB_TYPE (= DSTSK_ENUMEND) i 


M 
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RECORD STRUCTURE DST RECORDS 


Record structures, or simply records, refer to the aggregates of non- 
homogeneous components found in many | nguage - In some Languages, 
such constructs are called ‘‘records’’ (in PA a and COBOL, for example) 
and in others they are called ‘‘structures’’ (in PL/I, for example). 
Here we will call them ‘‘records’’. What all records have in common is 
that phey consist of a set of named components, each corresponding to 
some field in the record structure. The components can in general be 
of any data types supported by the Language. 


In the bebup re Table, a record is represented by a Record Begin 
OST record fol bject dS roceres, -— eg 
ny data 


pe 
of the components. However, only data DST records denote record com- 
ponents. 


Nested records are defined by record components which are themselves 
records. The type of a record component which is itself a record is 
defined by another Record-Begin/Record-End pair of DST records. This 
additional record definition may appear inside the original record 
definition, but does not have to do so--an Indirect Type Specification 
pointing to a record definition outside the original record definition 
is also legal. Conversely, a record definition inside another record 
definition does not define a nested record unless some component of 
the outer record actually references the inner record definition. In 
short, the DST can only describe one level of record components at a 
time, but any component can be of any arbitrary data type including 
another record type. 


The Record Begin DST record is unusual in that it can define both a 
data tyes and a data object. If the DST$B_VFLAGS field has the special 
value DSTSK_VFLAGS_NOVAL, then the Record Begin DST record defines an 
abstract data type. a | object of this data type must be represented 
oy a Separate Type Specification DST record which immediately precedes 
either the Record Begin DST record oF 4 Type $ oc tices ten DST record 
that contains an Indirect Type Specification that points to the Record 
Begin DST record. In this case, the name in the Record Begin record is 
taken to be the name of the data type, not of any object of that type. 


However, if the DST$B_VFLAGS field does not contain DSTSK_VFLAGS_NOVAL, 
then the Record Begin DST record defines both a data type and a data 
object of that type. This form can be used for languages guch as COBOL 
wh ch do not have named data types. In this case, the VFLAGS and 
D°TSL VALUE fields specify the address of the record object Tn the same 
way as in the Standard de a DST record. It is still legal to have 
cations pointing to this Record Begin DST record, 


Indirect T Specifi 
soy bas ft strict y as a type definition. 
Some languages, such as PASCAL, allow record variants. (In ADA, the 


N 
TBKDST .REQ;1 16-SEP-1984 16:58:1%.08 Page 79 


same concept is called ‘‘discriminated’’ records.) An objest of a record 
type with variants contains some set of components found in all objects 
of that type plus some set of components that vary from one record 
variant to the next. Which of the varying components are actually 
present in a given recore may be determined by the value of a ‘'ta 
variable’ which is a { xed component of the record. Variants may also 
be nested so that variants have variants. 


In the DST, record variants are described by Variant Set Begin DST 
records, Variant Value DST records, and Var =“ 9 A End DST records. 
The Variant Set Begin DST record marks the beginn ng of a set of record 
yer lente. where each variant consists of some set of record components. 
The Variant Set Begin DST record indicates which recerd component son 
stitutes the tag variable that discriminates between the variants in 
the set. This a9 variable must be a component of the same record and 
must precede the Variant Begin DST record in the DST. The Variant 
sogre, De; Fecere also gives the bit size of the variant, if known at 
compile-time. 


The Variant Value DST record marks the beginning of a single record 
variant. It also specifies all tag variable values or value ranges 
that indicate the presence of this variant in a given record object. 
ALL record components (indicated by data DST records) after this Vari- 
ant Value DST record and before the next Variant Value or Variant Set 
End DST record are taken to be components in this variant. 


The Variant Set End DST record marks the end of some set of variants 
wisps o recere specification. It also terminates the last variant 
w n the set. 


A record type with variants is thus specified as follows. First a 
Record Begin DST record marks the beginning of the record specifica- 
tion. After that come data DST records that denote all fixed compo- 
nents of the record type. Then comes a Variant Set Begin DST record 
that marks the beginn ng of a set of variant definitions and identi- 
fies the tag variable (if any) for that variant set. Immediatel 
thereafter comes the first Variant Value DST record. It marks the 
start of the first variant and identifies the values or yolue ranges 
of the tag variable that correspond to this specific variant. 


After the first Variant Value DST record come the data DST records 

for the record components in this particular variant. Next comes the 
Variant Value DST record for the next variant, along with its component 
DST records, and so on for each variant in the yor tent set. After the 
Last component DST record for the last variant in the set comes a 
Variant Set End DST record. It is followed by the DST records for any 
additional record components, pose toty including additional variant 

set definitions. Then comes the the Record End DST record. 


Variant sets may be nested inside variant sets. Such nesting is_indi- 
cated in the DS by the corresponding proper nesting of Variant Set 
Begin and Variant Se 


t End DST records. 


1 
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THE RECORD BEGIN DST RECORD 


The eecere Begin ud! qrecpre —s the pes toning of a record type 
definition in the DST. It must be followed by the dst records for 

the components of that record. ind by a shy ng Record End DST record. 
The Record Begin DST record has essentially the same at as the 
Standard Data DST record. but with two exceptions. pin TF an extra 
lLongword gives the bit length of the record ty ype en nd second, the 
DBGSB_VFLAGS field may have the special value DSTSK_VFLAGS “NOVAL to 
indicate that this is strictly a type definition, not also the defini- 
tion of a record “4 ect. . a normal value specifi fication is used, a 
record object is being declared as well as a record type. In this 
case, a Trailing Value Specification may be included at the aad M the 
DST record if necessary to describe the record's address. 


The bit size of objects of this record type is also given in the DST 
record. This size should be included if the size is known at compile- 
time. If it is not known at semptiertiaa. it should be specified as 
zero. 


This is the format of the Record Begin DST record: 


gmeene en ecc ae ee noon ae Sen enee een me cane een en ene rem ee een ene em een eee + 


' 
i} 
' 
' 
' 
' 
' 
4 
‘ 
' 
{ 
' 
' 
' 
' 
' 
i] 
i] 
' 
‘ 
' 
' 
! 
' 
' 
' 
' 
: byte i: = ' 
b i _DSTSB_ TYPE (=DSTSK ~REGBEG) i 
' 
' 
' 
1 
' 
' 
' 
' 
! 
' 
4 
1 
] 
' 
] 
1 
‘ 
] 
] 
' 
‘ 
F 


' byte i DST$B_LENGTH i 
! tm m mmm nw enn nn nee ene e nese ene e eee e ne ses ene sess esses sesesseeses + 
! byte H DST$B -VFLAGS _ H 
i Long ! DSTSL “VALUE i 
i byte : __DSTSB_NAME \ 
i var H ' 
The Name of the Record or Record Type in ASCII ' 
(The name's length is given by DSTSB_NAME) 
, Seiten PPS ROS SE SHOOTS SS BDH ST Sea SNS OOS SS See BOSS ES Se Se RO ee + 
! Long H DSTSL -RECBEG_ SIZE ! 
i Define the fields of the Record agi by DST pecans Also declare the macro 
! that defines the trailer part of the DST record. 
FIELD DSTSRECBEG_TRAILER_FIELDS = 


DSTSL_RECBEG_SIZE =C0,L.] ! The bit size of data gbjects of this 
TES i record type (or f unknown) 
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TBI 

MACRO 

DSTSRECBEG_TRLR = BLOCKC,BYTE] FIELD(DSTSRECBEG_TRAILER_FIELDS) %; 
: THE RECORD END DST RECORD 
i 
‘ The Record End DST record marks the end of a record type definition in 
: the DST. In effect, it terminates the scope set up by the matching 
Record Begin DST record. This is the record's format: 
i 
i (anhinannSeneeoeEerentied conioenanicieniimetenetie cewoneneneunent 
} byte H DSTSB_LENGTH (= 1) ! 
byte DSTSB_TYPE (= DSTSK_RECEND) 
ee rm sew eo sees eee een acene wee wesweweweewceocnne eoeewonone + 


' 
i 
i 
' 
i 
' 
! 
' 
i 
i 
F 
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THE VARIANT SET BEGIN DST RECORD 


The Variant Set Begin DST record aerke the beginning of the DST 
description of a set of record variants. This DST record also 
identifies the tag variable that discriminates between the variants 
mn the variant set. The tag variable is identified by a pointer 

to the DST record for the tag var able. This DST pointer consists 
of a byte address relative to the start of the DST. The size in 
bits of this variant set, meaning the size of the largest variant 

in the set, is also included. If this size is not known at compile- 
time, it should be set to zero. 


This is the format of the Variant Set Begin DST record: 


byte ‘ DSTSB_LENGTH H 
byte H DSTSB_TYPE (= DSTSK_VARPEG) ' 
byte ! DSTSB_VFLAGS H 
long | DSTSL_VALU H 
byte | DSTSB_NAME H 
$e er sane ee occ e en ane eee eS See errr aan t Been ee wee eer m emer wm eer ecerrer ee ee + 
var H H 
The Name of the Variant Set in ASCII 
(The name's Length is given by DST$B_NAME) 
(This name is normally null) 
o Se ee ee Se SSS eee eee Sees" OSS SSS SSS SSS SESS SSSSSSSESSE SSS e + 
Long ! DSTS$L_VARBEG_SIZE ! 
long ! DST$L_VARBEG_TAG_PTR H 


Define the fields of the Variant Set Begin DST record. Also define the 
declaration macro for the trailer part of the record. 


IELD OSTSVARBEG_TRAILER_FIELDS = 


ne EE EE EE EEE ETE EEE TOE Ee a as a tn at i. am 
+ 
t 
t 
4 
4 
‘ 
‘ 
i] 
' 
' 
i 
' 
a 
é 
i 
f 
' 
4 
$ 
t 
6 
t 
a 
a 
‘ 
t 
i 
‘ 
t 
i 
t 
q 
t 
a 
‘ 
im 
‘ 
‘ 
a 
t 
¢ 
a 
a 
a 
t 
qa 
’ 
3 
a 
i 
a 
t 
‘ 
‘ 
J 
t 
v 
J 
a 
4 
‘ 
a 


DSTSL_VARBEG_SIZE =C€0,t. 1], ! Size in bits of variant part 
: of record (or zero) 
DSTSL_VARBEG_TAG_PTR =(€4, tL. 1] ! Pointer to TAG field DST 
! record relative to the 
res ! start of the DST 


MACRO 
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DSTSVARBEG_TRAILER = BLOCKC,BYTE) FIELD(DSTSVARBEG_TRAILER_FIELDS) %; 


=" 
wm 


' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
: 
' 
. 
' 
. 
' 
. 
' 
: 
' 
: 
' 
. 
' 
. 
' 
. 
' 
. 
' 
M 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
M 
' 
: 
' 
. 
' 
* 
' 
. 
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THE VARIANT VALUE DST RECORD 


The Variant Value DST record marks the beginning of a new record 
variant within a variant set. It also marks the end of the previous 
variant (if ony? It is always vound between a Variant Set Beg n 
and a Variant Set End DST recore’:. Since the Variant 3 Begin DST 
record has already sper fied the cag variable, the Variant Value 

DST record only specifies the tag value or va rt that correspond 

to the present variant. It also specifies the size in bits of this 
variant if known at compile-time (otherwise zero is specified). 
Variant Value DST recere is followed by the Cote DST records (includ- 
ing nested variants if appropriate) which constitute the components 
of this specific variant. 


A variant may have many tag values or tag value ranges. This DST 
record thus speg ities a set of tag value ranges. The way these 
ranges are specified is described in detail on the following page. 


This is the format of the Variant Value DST record: 


teeece erro eoee= eeeeeeoeereseses eroceceoeeec= Sere oeeeeesseesesoes= + 

ee Se Bio tar nO wo eM ; 
aed ON ea tke dat Bh dh a eae 5 AONE ce ; 
nei EO Sodaeaiaiiiots Brine cena a RE onc Pa : 
saints ST et eS al nner nent Ei ; 
vari DSTSA_VARVAL _RNGSPEC 

Zero or More Tag Value Range Specifications 

(The number of Range Specs is given by DST$W_VARVAL_COUNT) 

Spscesistsiepnsinninatiniahenchliaheptidenmaiepamneeeeeaiestaliaintaentdis : 
Define the fields of the Variant Value DST record. 


! 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
; byte 
i 
i 
i 
i 
i 
i 
i 
' 
i 
i 
i 
i 
i 
' 
i 
i 
i 
i 
i 
F 


IELD DSTSVARVAL_FIELDS = 
SET 


DSTSL_VARVAL_SIZE = f 7 & } ! Bit size of this variant part 

DSTS$SW_VARVAL_COUNT = 6, WL The number of fag value ranges 
: which follow 

DSTSA_VARVAL _RNGSPEC =(8,A_] Location where the tag value 


range specs star 
TES; 


F 
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TAG VALUE RANGE SPECIFICATIONS 


Each Tag Value Range Spec! {ication in a@ Variant Value DST record 
conpiets of a byte specifying the bine f the . nge s rg Ply ty 
followed by one or two value 'sp Spectre cations. one ue Speci 
fication given, that 

that one value. [f two Value Spe 
fy the lowest and highest values in the tag value range. 
strations below show the two possible formats of Tag Value Range 
Specifications: 


+ eeecee Seeeeeaeeanoeene Se ee eoeeoeoeoaneo See S22 S22 S22 SSS eee eeeeeen ort ae @eewrn ee eseecee 


byte ‘ DsTSB -VARVAL -RNGKIND (= DSTSK ~VARVAL _SINGLE) 


Specificetion 


TES; 
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n 


ee i 9 va a range oone sts of 
f get ons are given, t ney spe t= 
The illu=- 


+ 


{ 
i 
; 
: 
i 
i 
i 
i 
i 
i 
i 
i 
i 
} 
i ' 
i Se eee oeeooneeaeaeen Sea DS ee eee eee ote woe eae Dabaoequeaesaes eeecee ’ 
var} “DSTSA _VARVAL “RNGADDR 
A DST Value Specification Giving a Variant Tag Value 
ee ! 
i teescecce ere eee meneame wen ear e enw en SP ee am oe oe oe me em ee weer eeeeeeon Cen ame + 
' 
i 
i 
' ie es SOS eee Pe eee Re SBE OB eee BOOM EBS + 
byte : __DSTSB_ VARVAL -RNGKIND_ i DSTSK -VARVAL _RANGE) H 
ivar 3 DSTSA_VARVAL_RNGADDR 
A DST Value Specification Giving the Lower Bound 
for a Range of Variant Tag Values 
SA | 
i tower cere esrene eee ee eee See eS eseeceeceoeeoaeer™ = Se eee een sees eecaneeooeeen + 
! var : : 
A DST Value Specification Giving the Upper Bound i 
for a Range of Variant Tag Values 
bad ! 
i + — Sse eS Seer were eneer = ome ee ee ee eee Seer eeree nsec mre ee eee ewe wweor em ew = oon 
' 
i 
Define the fields of the Tag Value Range Specification. 
FIELD DSTSYARVAL RNG_FLELDS = 

DST$B_VARVAL_RNGKIND = f 0, B. }: ! Tag Value Range Spec kind 

DSTSA_VALVAL_RNGADDR = [ 1, A ; Location of first Value 


pereier sw, 


“4 
ow 


' 
i 
' 
' 
' 
' 
' 
' 
' 
: 


H 
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H Define the possible values of the DSTSB_VARVAL_RNGKIND field. 


LITERAL 
DSTSK_VARVAL_SINGLE = 1, ! The range consists of a single value 
DSTSK_VARVAL_RANGE = 2; ! The range is given by a lower and an 
; upper bound (two value specs). 
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com! 
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THE VARIANT SET END DST RECORD 


The Variant Set End DST record marks the end of record variant set; 
it terminates a set of var ants which have the same tag variable. 
This is the format of the Variant Set End DST record: 


$e eee eee eee ee See eee eee eee eee Ses Sess eeeeeseeeeeseseeesesesoe} 
byte } DSTSB_LENGTH (= 1) \ 
byte | DSTSB_TYPE (= DSTSK_VAREND) : 
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BLISS DATA DST RECORDS 


records. ore nary scalar objects, such as $s {ntegers, are repre- 

sented by t he Standard Data DST record or its re ants. However, the 

more specialized BLISS data types such as Vectors, Bitvectors Blocks, 

and Blockvectors, are paprosensee oelat @ special DSf record called the 
nt 


BLISS data objects are Slarobferts, suc by Ras. sinpl eitte rent kinds of DST 
mp 


Yield names are penrocsrase by their own kind of DST record. the A558 
j ‘4 bed in th 
section. 


The BLISS Special Cases DST record and the BLISS Field DST record are 
supported for BLISS only. They should not be generated by compilers 
for any other Language. 


' 
i 
' 
i 
i 
i 
L 


K 
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byte 
byte 
byte 
byte 
byte 
byte 


var 


Long 
byte 
var 


long 


THE BLISS SPECIAL CASES DST RECORD 


The BLISS Special Cases DST record is ysed to describe a number of 

data objects whose data types are specific to the BLISS Language. only. 
This includes such objects as BLISS Vectors eB: tvectors, Blocks, and 

eoacnuweuere ong pointers to these objects {Rr F VECTOR, REF B é ° 

and so on). s DST record should not be generated for any language 
other than BLISS. 


This DST records consists of four parts: The DST header Abb ef the 
field # i9 in the set DSTSBLI FIELD, a variable-length aff, f fields. and 
the fields in the set DsTsaLt thal L FIELDS, The variable-length set 

of fields can be empty, consist of fhe fields in OSTSBLI_VEC_FIELDS 

the fields in DSTSBLI BIivEC FIELDS. the fields in DST acl gecoc FIELDS, 
or the fields in DSTSBLI_BLKVEC_FIELDS. Which set of fields egpears 

n the variable-length part depends on the value of BLISV_BLI_STRUC, 


\ DST$B_ TYPE ( (= DSTSK_BLI) ' 


+= See eeeeoeeee eeeecoeeceo Sueoneueneneuseonens eeeecoeceoe Seeeeeeoeoneoanonoaaneae + 


' DST$B_BLI_LNG 


¢ece Sree reese = = SSS eSSSeerecenseoseeeeesseus FE ee ew eee wnoemecaas + 


DSTSB -BLI_FORMAL ' 


eSeeeoeoeoeee Trew ew eer reece = Se eeeeoeeoeee eeoueeveesseossouse Seeeoeeeaenenee + 


DSTSB -BLI_VFLAGS H 


: 

EAE ee aN IM a eecee}oceoeeocooece eeeececooooen+ 
‘Bu! “REF a Unused--Must Be Zero : DST$V_BLI_STRUC ! 
* “DSTSA_BLI_SYM_ATTR 
Variable-Length Portion of DST Record 


fewer om erese= weeeceecoeoeeoan wemnenecceeece SSO Oe RES OD OEE eM eee TASS ow + 
' 
' 


DSTSL_BLI_VALUE i 


poe wwmaaan eeeee2ee2 Seeeeeoee2eoeeee Se em ee ee ee Se 


DSTSB_BLI _NAME ' 


Seow ene ere eaane = Se Se 2 2 e teem ee BOE wee eS DET Se EO eT DC OO ew BS a oe 


The BLISS Symbol Name in ASCII 
(The name's length is given by DST$B8_BL1_NAME) 


a eee 


DSTSL -BLI_SIZE 


¢ teow menor momen wero oe en eeeescoususesroesoossossssoucoosossesescese + 


=@ 
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The yertable-Length portion of tyr ‘ DST record can have several forms 
as discussed above. One possibil ty is that it is absent altogether. 
This occurs if the DST$V_BLI *STRUC ¢ jeld contains DSTSK_BLI_NOSTRUC. 


However, if DSTSV_BLI_STRUC has the value DSTSK_BLI_VEC, the variable- 
Length portion of the DST record has the following format 


bow eeecee ewer reer er ce etere® 2 ZT @® ee ®eoeenmeoeoeoeeoeoceee See ee See eeeeeneeneanean ween} 
Long ‘ DSTSL ~8t1 VEC. UNITS ! 
! byte : DsTSv Bul -VEC_SIGN_EXT DSTSV -BLI_VEC_UNIT_SIZE ! 


If OSTSV_BLI_STRUC has the value DST$K_BLI sBITVEC. the variable-length 
portion of the DST record has the following forma 


es eee ce nnn w wenn nne ene ene ee eeeeeenneneeeee + 
long H DSTSL_BLI_BITVEC_SIZE ! 


If DSTSV_BLI_STRUC has the value DSTS$K_BLI_BLOCK, the variable-length 
portion Of the DST record has the following format: 


EE eoewe eo wen ew www enn wooo enone neee- eoweeoeowenooncne + 
Long ' DSTSL_BLI ~BLOCK UNITS ! 
byte ' Unused i DST$V_BLI BLOCK UNIT. -SIZE_ H 


If DST$SV_BLI_STRUC has the value DSTSK_BLI_BLKVEC, the variable-length 
portion of the DST record has the following format: 


S Tastee Dette Tattoo oanerneH- + 
Long i DSTSL_BLI_BLKVEC -BLOCKS 
long ! DSTSL_BLI_BLKVEC “UNITS ! 

! byte i DST$B_BLI_BLKVEC_UNIT_SIZE 


pot'ine the fields in the header portion of the BLISS Special Cases DST 
ecord. 


M 
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FIELD BST SOL 1 FIELDS = 


E 
DST$B_BLI_LNG =({2, 6.1], ! Length in bytes of the set of 
jields between this one 

! and_TRAIL_FIELDS 

! between 3 and T2 
DSTSA_BLI_TRLR1 *{ 3. Aa. 1, ! The first prettier is at this 

! coset on + DSTSB_BL Li uN LNG 
DST$B_BLI_FORMAL =(3, 86.1], ! Flag set if this symbol 

! routine forma paraneter 
DST$B_BLI_VFLAGS = f 4, 8 ' Value access information 
DST$B_BLI “SYM_ TYPE = B 


J 

1 

' 

' 

' 

' 

! 

' 

i 

: The type of the a , mbo 

44 described h 4 gn Fe 
{ 
' 
1 
1 


lowing sub-field 
DSTS$V fut _STRUC = » V.(0,3) ! The structure of ths symbol 
Unu = 2° v_(3,4) ! This field Must B ro 
bstsy" *aLI REF = - Vi(7,1) ! Flag set if this is H REF 
: 1 = REF, 0 = no REF) 
DSTSA_BLI_SYM_ATTR =(€6, A, J ! Address of variable Len th 
attribute segment 
res this DST record 


These are the possible values of the DST$B_BLI_STRUC field. 
LITERAL 


DSTSK_BLI_NOSTRUC = 0, ' Not a BLISS structure 
DST$K_BLI_VEC = 1, ! BLISS Vector 
DSTSK_BLI-BITVEC = ¢° ! BLISS Bitvector 
DST$K_BLI-BLOCK = 3, ' BLISS Blo 
DSTSK_BLI-BLKVEC = 4; ! BLISS Blockvector 
Define the fields in the variable-length Bue stro BLISS Spec tat Cases 
DST record when the value of the BLISV_ true nu d is DSTSK_BLI_VEC. 


This field describes a BLISS Vector. 
FIELD DSTSBLI -VEC_FIELDS = 


DSTSL_BLI_VEC_UNITS ef 6. tj. tunber | Of elements allocated 
e vector 
DSTSV_BLI_VEC_UNIT_SIZE = (C 10, v_(0,4) Je } hs ~~ & pionen unit 
size: 1 = 


word, and < *tongvord 
DST$V_BLI_VEC_SIGN_EXT = (C 10, V_(4 143 ' Sign extension flag: 
= sign extension 
0 = no sign extension 


TES; 


Define the fields in the var taplenten th buf st BLISS Special Cases 
DST record when the value of the B BL Struc meu d is DSTSK_BLI_BITVEC. 
This field describes a BLISS ot em 


FIELD DSTSBLI_BITVEC_Flcivs = 


= 


' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
i] 
. 
' 
. 
' 
. 
' 
. 
' 
* 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
: 
' 
. 
' 
. 
' 
. 
' 
: 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
: 
' 
. 
' 
: 


N 
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SET 
Ps TSL_BLI BITVEC SIZE = (€ 6, L_ ] ! The number of bits in the bitvector 
! Define the fields in the vartepleston th BLE StRU the ety spec tat Cases 
i DST rears when the value of the BLISV_ Frage field is DST$K_BLI_BLOCK. 
These fields describe a BLISS Block. 


FIELD DSTSBLI_BLOCK_FIELDS = 


DSTSL_BLI_BLOCK_UNITS =(€6, tL. J, ! The number of units allocated 
; in the block 


DSTSV_BLI_BLOCK_UNIT_SIZE = C 10, v_(0, 4) ] ! The unit size of the 
block: 1 = byte, 2 = 
Tes word, and 4 =: Longword 


Define the fields in the hes tg th Meet f the BLISS Spec cial Cases 
DST record when the value of the BLISV_BLI_STRUC field is DST$K_BLI_BLKVEC. 
These fields describe a BLISS Beockioctone” 


FIELD DSTSBLI_BLKVEC FIELDS = 
DSTSL_BLI_BLKVEC_BLOCKS sé, t J The near of Backs in the 
DSTSL_BLI_BLKVEC_UNITS = f 19 10, L * §- .} i The number of units per block 


DST$B_BLI_BLKVEC_UNIT_SIZE = The block unit size: 1 = byte, 
res = word, 4 = lLongword 


eet tr ord 


! Define the fields in the first trailer portion of the BLISS Special Cases 
DST record. Also define the declaration macro. 


FIELD DSTSBLI_TRAIL1 FIELDS = 
DSTSL_BLI_VALUE = C 0, L_ J. 


' 
i 
i DST$B 
C4, 8. J, Count dhe thee coated name 
i 
1 


DST$B_BLI_NAME = 

counted ASCII string 
DSTSA_BLI_TRLR2 = C 5, A_ J ' The second trailer starts at this 
rs : location + DST$B_BLI_NAME 


MACRO 
DSTSBLI_TRAILER1 = BLOCKC,BYTE] FIELD(DSTSBLI_TRAIL1_ FIELDS) 2; 


! Define the fields in the second trailer portion of the BLISS Special Cases 
DST record. Also define the declaration macro. 


FIELD DSTSBLI_TRAIL2_FIELDS = 


Tt 
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sAgoMW 


ET 
gist Sul size etd, t. 2 ! Size of the Bliss data item in bytes 


MACRO 
DSTSBLI_TRAILER2 = BLOCKC,BYTE] FIELD(DSTSBLI_TRAIL2_FIELDS) %; 
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byte 
byte 
byte 
long 
byte 


var 


' 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
' 
i 
i 
i 
i 
i 
i 
' 
i 
i 
i 
' 
i 
i 
i 
i 
' 
i 
' 
i 
: var 
' 

i 

i 

i 

i 

i 

i 

i 

i 

i 

i 

i 

i 

F 


THE BLISS FIELD DST RECORD 


The BLISS Field DST record describes a BLISS field name. BLISS field 
names are declared in FIELD declarations in BLISS. Each BLISS field 
name is bound to an n-tuple of numbers. Usually the n-tuple is a four- 
tuple and the numbers represent a byte or a eet offset, the bit 
offset within that byte or longword, the bit length of the field being 
described, and a sign-extension flag. DEBUG supports references to 
such fields in BLISS Blocks and Blockvectors. owever, a BLISS field 
can be any n-tuple. If n is not 4, the field name can only be used in 
EXAMINE commands, but not in Block or Blockvector references. 


The BLISS Field DST record should not be generated for any Language 
other than BLISS. This is the format of the record: 


$¢ rer eee eer eee eee ene ae Serre wwe naan ereser seme ec enecocm mane mn ener eraesee + 
! DSTS$B_LENGTH H 
H DSTSB_TYPE (= DSTSK_BLIFLD) i 
! DST$B_BLIFLD_UNUSED i 
‘ DSTSL_BLIFLD_COMPS H 
Hl DST$B_BLIFLD_NAME H 
The Name of the BLISS Field in ASCII 
(The name's Length is given by DSTSB_BLIFLD_NAME) 
+ See eee eeee ee eceeseee Seeeeeooeooece Hew eo ee wee Se SE Se me ew Se ee SS + 
A Vector of Longwords Containing the Integer 
Values of the Components of the BLISS Field Definition 
(The number of values is given by DSTSB_BLIFLD_COMPS) 
} eseeecee SSS SSS SSS SSS SSS SSS SSS SSF SSS SF SSO See eneanee See eee eee ee eee eeene * 


Define the fields of the BLISS Field DST record. 
IELD DSTSBLIFLDO_FIELDS = 
SET 


DST$B_BLIFLD_UNUSED = - 8. de ' Unused--Must Be Zero 
DST$L_BLIFLD_COMPS 7 » &. oe ! The number of components 
DSTSB_BLIFLD_NAME = e 8. } 


! The count byte of the field 
TES ; name Counted ASCII string 


D1 
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LABEL DST RECORDS 


Labels are represented by two different DST records. A label, in the 
sense used here, is a symbol bound to an instruction address. Labels 
do not include routine, lexical block, and erty point symbols, however. 
A label can be represented by either a Label DST record or a Label-or- 
Literal DST record. The Label-or-Literal DST record is intended only 
for Language MACRO, it appears. (The aiptery on the origin and intent 
of this record is unclear, however.) ALl other Languages should use 
the Label DST record for [abels. 


THE LABEL DST RECORD 


The Label DST record specifies the name and address of a label in the 
the current module. A label in this sense is always bound to an in- 
struction address, not a data address. This is the DST record normally 
used for labels in high-level languages. The DSTSL_VALUE field of this 
record contains the code address to which the label is bound. 


This is the format of the Label DST record: 


nad NOELIA VS EET 
wee Lasjiaialgaaiamabteret Reootaseueese eters mei Leddieenaielin ; 
ing > EL Re SES tn Ria ns De Me OE SESS ; 
WOOD Se sigeahiancs eamaihinas tnd th ork tN a a ; 
ype NS Rn seo te tae FER he SEE OT ; 
oe The Label Name in ASCII 

(The name's Length is given by DST$B_NAME) 

isintaaidiianetapsineiatioonsnintnkaaienaminenes Are Soe : 


TSKDST.REQ;1 16-SEP-1984 16:58:18.03 Page 96 


byte 
byte 
byte 
Long 
byte 


var 


THE LABEL-OR-LITERAL DST RECORD 


The Label-or-Literal DST rorery 8 specifies the name and george s of a 
Label (meaning a code locat the ame | and value of an inte eger 
Literal (a named constant). It is not rely clear why this DST 
record exists since labels can be described by Label DST records and 
integer ieere s can be Contr teed & the stander Data DST records. 

Most yheiy SP s DST record was intended for yenquege, MACRO wyere 
there is Little ‘distin tion af og labels and Literals; one. s relo- 
catable and the other is not, but that is about all. If D V=VALKIND 
has the value rie VALKIND kopn’ the symbol is a label and Stee t has 
the value DSTSK_VALRIND_LITERAL, the symbol is a literal. The address 
of the label or the valce of the Literal is found in the osih. VALUE 
field. It is recommended that high-level languages avoid t 


record and use the Label DST record or the Standard Data os} BLP 
instead. 


This is the format of the Label-or-Literal DST record: 


i DST$B_ LENGTH i 


tose menoan SS ee we Oem EOE ERE MOM BO ORR ERE RRO Em ORR OO me Oe + 


' _DSTSB_ TYPE (= DSTSK_LBLORLIT) 


eS Om em ef 


4 
3 
Cc 
w 
@ 
as 
ti 
Cc 
“ 
7 
@ 
@ 
N 
@D 
3 
o 
+--+ 
‘~] 
7) 
pa 
wn 
= 
‘< 
> 
-1 
x 
sol 
2 
i=] 


+ 

The Label or Literal Name in ASCII 
(The name's Length is given by DSTS$B_NAME) 
+ 


~ 
@w 


F 
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' 
. 
! 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
rc 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
i] 
* 
i] 
. 
i] 
. 
' 
. 
' 
* 
' 
. 
' 
. 
' 
. 
' 
. 
! 
. 
' 
. 
! 
. 
' 
. 
' 
. 
' 
. 


THE ENTRY POINT DST RECORD 


The Entry Point DST record describes an ENTRY name in the FORTRAN or 
PL/I sense. In other words, it describes a secondary entry point to 
the routine within which this DST record is nested. This record should 
never be generated for the main — point to a routine since that 
entry point is already described by the Routine Begin DST record. An 
entry point described by the eneey Point DST record is always assumed 
to be called through the CALLS/CALLG instructions (not JSB/BSB). The 
DSTSL_VALUE field contains the address of the entry point. 


This is the format of the Entry Point DST record: 


att SURE OY 
ached | MSO SO IR i Ne BAS ne) SE Ae H 
MOTT e os ccetueaaeniien PII an. ttn Bie eo MA RET jet a 
Ca | ONE RIS, 5 sh om on FR re TD ; 
adage Rah PRT A ck can Bie AER NE Pe Le ea : 
ons The Entry Point Name in ASCII | 

(The name's length is given by DSTSB_NAME) 

Siinesbeiieanntesiuisenessicuatnadevensanuietaieniitivaiaennsouattnnaiinshantetiineoinasistiins : 


ee 


st 
@o 


Sas ger 


= 
@w 


1 
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THE PSECT DST RECORD 


a PSECT 4 Ray ot 4 .goec' figs the name, address ang Length of 

PSECT, wh $ @ Program Section in the Linker sense. 
PSE CT po§t reolede po only used for Language MACRO upere,. it is 
4G A. to generate code or data at the beginn epg.of of a PSECT 
without having ony other label on that code. DEBUG ignores PSECT 
DST records for all other Languages since high-level anguages 
have other code and data labels 


This is the format of the PSECT DST record: 


hat are more appropriate. 


+ eeeeeceoe See eceeeoeeae SSS SS SS SS SSS SSS SSS eeeenenea eeeceeecee seeeeoeanoceen } 


! 

! 

1 

! 

1 

! 

! 

! 

1 

1 

! 

i 

' 

1 

1 

i 

| byte : DSTS$B_LENGTH ! 
} byte i DSTSB_ TYPE (= DSTSK _PSECT) i 
; byte i DSTSK_PSECT_UNUSED : 
long : DSTSL_PSECT_VALUE i 
byte } DSTSB_PSECT_NAME (also DSKSB_PSECT_TRLR_OFFS) _ i 
iver | DSTSA_PSECT_TRLR_BASE 
The Name of the PSECT in ASCII 
(The name's Length is given by DSTSB_PSECT_NAME) 
i 
' gee eee ee ee ewe nm crcoen Swe e Deen DOE eee woen cement e seme me ewe emo eee + 
{ Long : __DSTSL ~PSECT “SIZE i 
: Define the fields of the PSECT DST record. 

F 


FIELD DSTSPSECT_ FIELDS = 
DST$B_PSECT_UNUSED 
DST$L~PSECT~ VALUE = 
DST$B_PSECT_NAME 

DSTSB_PSECT_TRLR_OFFS = (C 7, 
DSTSA_PSECT_TRLR_BASE = C 8, 


TES; 


Unused--Must Be Zero 
Start address of the PSECT 
The _—_ byte in the PSECT 
nted att! string 
Byte offset to the PSECT DST 
record trailer fields 
Base address for offset to 
DST record Rett | ns. fields 


' 
i 
. 


' 
i 
i 
i 
‘ 
i 
i 
; 
i 
F 


" " 
eoCrrTl 
NWI! 
ese 
alt wt « fw 
eee) 
ees 


ee ee err 


: Define the PSECT DST record trailer fields. Also define the declaration 
' macro. 


a 
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FIELD DSTSPSECT_TRAILER_ FIELDS = 
Pate PSECT SIZE st dt, 2 ! Number of bytes in the PSECT 


MACRO 
DSTSPSECT_TRAILER = BLOCKC,BYTE) FIELD(DSTSPSECT_TRAILER_FIELDS) %; 


: Note that the address of the PSECT DST record tailer is computed as follows: 
i DST_RECORDCDSTSA_PSECT_TRLR_BASE] + .DST_RECORDCOSTS$B_PSECT_TRLR_OFFSJ 
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ee ee te ee te ee ee ee ee 


byte 
byte 


var 


LINE NUMBER PC=CORRELATION 
DST RECORDS 


The Line Number PC-Correlation DST record specifies the correlation 

between Listing Line numbers, as assigned by the compiler, an 

addresses. It thus the means whereby the compiler tells bEBUG where 

the generated object code for each source line starts and how lon 

ss, *s in aytees This is the format of the Line Number PC-Correlation 
record: 


¢ we moernreoneec rows eans Seaeecoteoceoee ee ances sons Eeoasoersaemacoes waaca} 


DSTSB_LENGTH ' 


bowen ane amare ow nae eS a me am 0 ee ee eee oe ee So ee co 


DSTS$B_TYPE (= DST$K_LINE_NUM) 


After the two-byte header, each Line Number PC-Correlation DST record 
contains a sequence of Line Number PC-Correlation commands. Each such 
command sets or manipulates one or more state variables used by DEBUG 
in the interpretation of these commands. The main state variables are 
the current Line number and the current PC address, but there are seve- 
ral others as well. The exact semantics of the various commands are 
described in the sections that follow. 


Line Number PC-Correlation DST records are associated with the module 
within which they appear. The must thus sepeer between the Module 
Begin and the Module End DST records for the current module. There are 
no further restrictions on where they may appear, however. In particu- 
lar, they need not be nested within the routines or lexical blocks that 
they describe. It is thus legal to generate all Line Number PC-Corre- 
lation DST records for a module after the last Routine End DST record, 
for instance. These records can also be interspersed between Routine 
and Block Begin and Eng records in ony way convenient for the compiler 
implementer. However it is done, DEBUG treats them as belonging to the 
module as a whole. 


The Line Number PC-Correlation information may be spread over as many 
DST records as necessary. Line Number PC- orretat on command may be 
broken across record boundaries, but otherwise the Line Number PC-Corre- 
Lation DST records within a module are considered to constitute a single 
command stream. The Continuation DST record may not be used to continue 
Line Number PC-Correlation DST records. 
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; Define the fields of the Line Number PC-Correlation DST record. 
FIELD DSTSLINE_NUM_FIELDS = 
FEL SALINE JUM_DATA =(€ 2, A, ] ! Start address of PC-correlation data 


LINE NUMBER PC=-CORRELATION COMMANDS 


Each PC-Correlation command consists of a command byte possibly fol- 
lowed by a parameter byte, word, or longword. The presence, size, and 
meaning of the parameter fielc {fs determined by the command byte. This 
illustration summarizes the structure of one command: 


fewmomanmencawr eer erm ene wee oneness eSeeeoeeaeeo Seeee eee ee eee eeeeeaeneane aoa h 


i byte | COMMAND _BYTE 
> Se BeBe eS Bee we oe oe we Se Se Ge em ee ee oe oe ee ee oe Spee earmen = Sew eae a> wa be 
' var t ' 
Zero or One Parameter Field 
(Byte, Word, or Longword) 
) a See Sew eae SS lerdal clair cen ee il ec el a a ele eel ee eo ee > 


The command byte contains a command code. If this command code is 
negative, this is a Delta-PC command. A Delta-PC command specifies 
by how aeny bytes to increment the PC to get to the start of the 

next Line (see detailed description below). This byte count is en- 
coded otrectty in the command pees If the command code is negative, 
its negative is the PC increment. The Delta-PC command has no param- 
eter field. If the command code is positive, it specifies some other 
command as described below. In this case, there may be a parameter 
field, depending on the command code. 


i Define the command codes allowed in Line Number PC-Correlation commands. 
the command code is zero or negative, the command is a one-byte Delta-PC 
! command. Here we define the command-code range for the Delta-PC command. 


LITERAL 
DSTSK_DELTA_PC_LOW = -128, ! The lower bound on Delta-PC commands 
DSTSK_DELTA_PC_HIGH = 0; ! The upper bound on Delta-PC commands 


' 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
; 
L 


' Define the PC-correlation command goges other than the Delta-PC command. 
: These command codes are always positive. 


LITERAL 


~ 
m 


i 
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byte 


byte 
byte 


byte 


! word 


' byte 
! long 


' Delta-PC Word command 


DSTSK_DELTA_PC_ = 1 ' 
DSTSK-DELTA-PC-L = 17, | Delta-PC Longword command 
DSTSK_INCR_CINOM & ¢° ! Increment Line Number Byte command 
DSTSK_INCR_LINUM_W = ! Increment Line Number Word command 
DSTSK_INCR hn L = 18, | Increment Line Number Longword command 
DSTSK-SET_CINUM_INCR = 4, ! Set Line Number Increment Byte command 
DSTSK_SET LINUM_INCR W = 5, ' Set Line Number Increment Word command 
DSTSK-RESET_LINOM_INCR = g. : Reset Line Number Increment command 
DSTSK_BEG_STMT_MODE = 7, ! Begin Statement Mode command 
DSTSK_END_STMT MODE = 8 ! End Statement Mode command 
DSTSK_SET_STMTRUM = 18, | Set pyetenens Number Byte command 
DSTSK_SET_LINUM_B = 19, ! Set Line Number Byte comman 
DSTSK_SET_LINUM = 9 ! Set Line Number Word comman 
DSTSK_SET_LINUM_L = 26, ' Set Line Number Longword command 
DSTSK_SET_PC = 10, ! Set Relative PC Byte c n 
DSTSK_SET_PC_W = 11, ! Set Relative PC Word comman 
DSTSK_SET_PC_L = \- ! Set Relative PC Longword command 
DSTSK_SET-ABS_PC = 16, ! Set Absolute PC Longword command 
DSTSK_ TERA = 14, ! Terminate Line Byte comman 
STSK_TERM_W = 15, ! Terminate Line Word command 

DSTSK_TERM_L = 21, Terminate Line Longword command 
DSTSK_PCCOR_LOW = -128, ! Smallest vaiue allowed in the first 

; are of a PC-correlation command 
DSTSK_PCCOR_HIGH = 21; ! Largest value allowed in the first 

: byte of a PC-correlation command 


The parameter field, if present, contains an unsigned byte, unsigned 
word, or longword value. The possible PC-Correlation command formats 
thus look as follows: 


¢ ewer ecereewocnan= Kem aamaoeamaw wece sesame cee ee SO OE Oe a wean eenaet 


COMMAND _BYTE 


¢ eer eee e ese e en ee rere nen emer nese eee noe cece See eee e2eeeeeeeneae eeeecee oo 


pw ew me wwe ewe wee meee cme ew eee ee ee ee eee we ew woe eee ween eesecne cose s oh 


geeerereeaen ewe we ee soe mee CBB OCP eee nee ne Bere Emam meee coer mamaa } 


' COMMAND _BYTE i 


$e Se Se Seee er eee e er Serr SOSH SSE SS SST See EBA Seeoaenwoemes Se eeeeeoeeeoe oo 


: NEXT_UNS_WORD (Unsigned Word Value) H 


gteseeceescecaeenewmeocecece eeeoeooee@ SSS SSS SSS SSSSSSSSSS SSS SSSSSSOeeeeeeee + 


$e seo sore ne aec oneness ewer Tee oeoUT ewer TsonrewsEenonenes eSeeeeeoeeeeoeee + 


' COMMAND _BYTE H 


eres ee wm eee Bees e ee ee sew easeeesmoee SoOGKSCH HOSS BOK HOMO E EEE ae Sem ame + 


: NEXT_UNS_LONG (Longword Value) ' 
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PC-CORRELATION COMMAND SEMANTICS 


The individual commands are a a tpperately below. To clarify what 
these commands “ali8s-{ do, each is fol Loved by a formal semantic de- 
nerrers = using BLISS-Like gPeeusenceee. s description show what the 
command does to a number of state variables used by EBUG ugen inter- 
preting these commands. The state variables are the following: 


CURRENT_LINE == The current Line number. 

puna “STMT == The current statement number. 

CURRENT_INCR == The current Line number increment. 

CURRENT_STMT_MODE == The Revenant mode ee set to TRUE when 
statement mode is set, set to FALSE otherwise; 

START_PC -- The start address oF the lowest-address routine 
n the current module; 

CURRENT_PC == The current PC yalue (code address). 

CURRENT_MARK == The | [yecepenzt none separ flag; ses to a <0ren 
when Line numbers are being defined and s 
LINE_CLOSED when a routine has been formlanens 
and few Lines are not being defined. 


The initial values of these state variables when the PC-Correlation 
commands for a given module are interpreted are as follows: 


CURRENT_LINE = t 

CURRENT— STMT = ; 

CURRENT— INCR = 

CURRENT “STMT movi = FALSE; 

START_PC = Start Be Bn of the lowest-address 
fous ine in the current module; 

CURRENT_PC = STAR 


PC; 
CURRENT_MARK = CINE. cLoseD; 


The sections below describe the format and semantics of each of the 
individual PC-Correlation commands. 


THE DELTA=-PC COMMAND 


This command defines a correlation between a Line number and a PC value. 
The current Line number is incremented by the current snerement i lue 
(normally 1) and the current PC value is incresentea b the nepati ve a" 
the command byte. The resulting Line number then pes. he feeu n 
value. in other words, both the Line number and the PC value are Hae. 
mented bef gre the correlation is established AL. e PC increment value 
(the negative of the command Ate thus specit ies how many bytes to go 
forward to get to the start o the Line being defined. These are the 
formal semantics of the command 


— 
nm 
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IF_CURRENT_STMT_MODE 

CURRENT_STMT = CURRENT_STMT + 1 

CURRENT_LINE = CURRENT_LINE + CURRENT_INCR; 
CURRENT_PC = CURRENT PC = PC_COMMANDCCOMMAND_BYTE); 
CURRENT-MARK = LINE_OPEN; 


The value of CURRENT_PC now contains the start address of the Listing 
Line specified by the values of CURRENT_LINE and CURRENT_STMT. Not 
that Line-open mode is now set. 


THE DSTSK_DELTA_PC_W COMMAND 


This command is Like the normal Delta-PC command except that the PC 
increment value is given in an unsigned word following the command 
code. These are the semantics: 
if CURRENT STAT MODE 
CURRENT _STMT = CURRENT_STMT + 1 
CURRENT_LINE = CURRENT_LINE + CURRENT_INCR; 
CURRENT_MARK = LINE_OPEN; 
CURRENT_PC = CURRENT_PC + PC_COMMANDCNEXT_UNS_WORD); 


The value of CURRENT_PC now contains the start address of the Listing 


Line specified by the values of CURRENT_LINE and CURRENT_STMT. Note 
that Line-open mode is now set. 


THE DSTSK_DELTA_PC_L COMMAND 


This command is Like the normal Delta-PC command except that the PC 
increment value is given in an unsigned longword following the command 
code. These are the semantics: 
IF CURRENT_STMT_MODE 
CURRENT_STMT = CURRENT_STMT + 1 
CURRENT_LINE = CURRENT_LINE + CURRENT_INCR; 
CURRENT_MARK = LINE_OPEN; 


= 


a 
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CURRENT_PC = CURRENT_PC + PC_COMMANDCNEXT_UNS_LONG]; 


The value of CURRENT_PC now contains the start address of the Listing 
Line specified by the values of CURRENT_LINE and CURRENT_STMT. Note 
that Line-open mode is now set. 


THE DS1S* _INCR_LINUM COMMAND 


This command increments the current Line number by the value given in 
the unsigned byte following the command code. If statement mode is set, 
the current statement is reset to 1 as well. These are the formal 
semantics of the command: 


CURRENT LINE = CURRENT LINE + PC_COMMANDCNEXT_UNS_BYTE); 
IF CURRENT_STMT_MODE TREN CURRENT_STMT = 1; 


THE DSTSK_INCR_LINUM_W COMMAND 


This command increments the current Line number by the value given in 
the unsigned word following the command code. If statement mode is set, 
the current statement is reset to 1 as well. These are the formal 
semantics of the command: 


CURRENT LINE = CURRENT LINE + PC_COMMANDCNEXT_UNS_WORD]; 
IF CURRENT_STMT_MODE TREN CURRENT_STMT = 1; 


THE DSTSK_INCR_LINUM_L COMMAND 


This command increments the current Line number by the value given in 

the unsigned longword following the command code. If statement mode is set, 
the current statement is reset to 1 as well. These are the formal 

semantics of the command: 


CURRENT LINE = CURRENT LINE + PC_COMMANDCNEXT_UNS_LONG]; 
IF CURRENT _STMT_MODE TREN CURRENT_STMT = 1; 


THE DSTSK_SET_LINUM_INCR COMMAND 


This command set the current Line number increment value to the value 
specified in the unsigned byte following the command code. If state- 
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ment mode is set, the current statement number is set to 1. These are 
the formal semantics of the command: 


CURRENT. INCR = PC_COMMANDCNEXT_UNS BYTE]; 
IF CURRENT_STMT_MODE THEN CURRENT_STMT = 1; 


THE DSTSK_SET_LINUM_INCR_W COMMAND 


This command set the current Line number increment value to the value 
specified in the unsigned word following the command code. If state- 
ment mode is set, the current statement number is set to 1. These are 
the formal semantics of the command: 


CURRENT _INCR = PC_COMMANDCNEXT UNS WORD]; 
IF CURRENT_STMT_MODE THEN CURRENT_STMT = 1; 


THE DSTSK_RESET_LINUM_INCR COMMAND 


This command resets the current line number increment value to 1. If 
statement mode is set, the current statement number is set to 1 as well. 
These are the semantics: 


CURRENT_INCR = 1; 
IF CURRENT_STMT_MODE THEN CURRENT_STMT = 1; 


THE DSTSK_BEG_STMT_MODE COMMAND 


This command sets statement mode, meaning that subsequent Delta-PC com- 
mands will increment the current statement number within the current 
Line and not the current Line itself. This gonnene is only allowed in 
the Line-open state. Statement mode can opt onally be used by Languages 
that have multiple etatonents per line. This command also set the cur- 
rent statement number to 1. These are the semantics: 


IF CURRENT _MARK NEQ LINE_OPEN THEN SIGNAL(Invalid DST Record); 
CURRENT_STAT_MODE = TRUE; 
CURRENT_STMT = 1; 


THE DSTS$K_END_STMT_MODE COMMAND 
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This command clears statement mode so that that subsequent Delta-PC com- 
mands will again increment the current Line number, not the statement 
number. The command also set the current statement number to 1. These 
are the semantics: 


CURRENT_STMT_MODE = FALSE; 
CURRENT-STMT~= 1; 


THE DSTSK_SET_LINUM_B COMMAND 


This command sets the current Line number to the value specified in the 
unsigned byte that follows the command code. These are the semantics: 


CURRENT LINE = PC_COMMANDCNEXT_UNS_BYTE]; 


THE DSTSK_SET_LINUM COMMAND 


This command sets the current Line number to the value specified in the 
unsigned word that follows the command code. These are the semantics: 


CURRENT_LINE = PC_COMMANDCNEXT_UNS_WORD]; 


THE DSTS$K_SET_LINUM_L COMMAND 


This command sets the current Line number to the value specified in the 
lLongword that follows the command coae. These are the semantics: 


CURRENT_LINE = PC_COMMANDCNEXT_UNS_LONG); 


THE DSTSK_SET_STMTNUM COMMAND 


This command sets the current statement number to the value specified 
in the unsigned word that follows the command code. The command should 
only be used when statement mode is set. These are the semantics: 


CURRENT_STMT = PC_COMMANDCNEXT_UNS_WORD]; 


= 
wo 
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THE DSTSK_SET_PC COMMAND 


This command sets the current PC value to be the value specified in the 
unsigned byte not ge dat the command code added to the start address of 
the lowest-address routine in the current module. This command is only 
allowed in the Line-closed state. These are the formal semantics: 


IF CURRENT_MARK NEQ LINE CLOSED THEN SIGNAL (Invalid DST Record); 
CURRENT_PC™= START_PC + PC_COMMANDLNEXT_UNS_BYTE); 


THE DSTSK_SET_PC_W COMMAND 


This command sets the current PC value to be the value specified in the 
ura tenes word following the command code added to the start address of 
the lowest-address routine in the current module. This command is only 
allowed in the Line-closed state. These are the formal semantics: 


IF CURRENT_MARK NEQ LINE CLOSED THEN SIGNAL (Invalid DST Record); 
CURRENT_PC”= START_PC + PC_COMMANDLNEXT_UNS_WORD 


THE DSTSK_SET_PC_L COMMAND 


This command sets the current PC value to be the value specified in the 
longword following the command code added to the start address of the 
lowest-address routine in the current module. This command is only 
allowed in the Line-closed state. These are the formal semantics: 


IF CURRENT_MARK NEQ LINE CLOSED THEN SIGNAL(Invalid DST Record); 
CURRENT_PC~= START_PC + PC_COMMANDLNEXT_UNS_ LONG); 


THE DSTSK_SET_ABS_PC COMMAND 


This command sets the current PC value to be the absolute address speci- 
fied in the Lengyere following the command code. This command is only 
allowed in the line-closed state. These are the formal semantics: 


IF CURRENT MARK NEG LINE CLOSED THEN SIGNAL(Invalid DST Record); 
CURRENT_PC™= PC_COMMANDCREXT_UNS_LONG); 


THE DSTSK_TERM COMMAND 


i] 
' 
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current routine or other program unit and specifies the number of byres 
in the Last fine epec ities by a Delta-PC command. Since the Delta-PC 
command specifies how many artes precede the Line being defined, the 
Terminate command is needed to say how many bytes ave n that Line 

r 


CURRENT_PC = CURRENT PC + PC_COMMANDCNEXT_UNS_BYTE); 
CURRENT-MARK = LINE_CLOSED; 


THE DSTSK_TERM_W COMMAND 


This command terminates the PC-Correlation command sequence for the cur- 
rent routine or other program unit and specifies the number of bytes in 
the Last Line of that program unit. It is a variant of the DSTSK_TERM 
command described above. The number of bytes in the last Line is speci- 
fied by the unsigned word following the command code. This command also 
sets the Line-closed state. These are the semantics of the command: 


< 


CURRENT_PC = CURRENT _PC + PC_COMMANDCNEXT_UNS_WORD]; 
CURRENT_MARK = LINE_CLOSED; 


THE DSTSK_TERM_L COMMAND 


This command terminates the PC-Correlation command sequence for the cur- 
rent routine or other program unit and specifies the number of ytes in 
the Last Line of that program unit. It is a variant of the DSTSK_TERM 
command described above. The number of bytes in the last Line is speci- 
fied by the longword following the command code. This command also sets 
the Line-closed state. These are the semantics of the command: 


' 
i 
i 
i 
i 
i 
£ 


= 
mm 


CURRENT_PC = CURRENT _PC + PC_COMMANDCNEXT_UNS_LONG); 
CURRENT_MARK = LINE_CLOSED; 


: END OF LINE NUMBER PC-CORRELATION DST RECORD DESCRIPTION. 
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byte 


var 
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SOURCE FILE CORRELATION 
DST RECORDS 


The Source File Correlation DST record is used to specify the correla- 
tion between Listing Line numbers on the one hand and source files and 
source file record numbers on the other. These records enable DEBUG 
to display source Lines during the debugging session. 


The Source File Correlation DST record has the following format: 


ger en ecw ee eee sn meer ee nce een eee eee ecw eSeeeeeeeeee moana mae bt 


; DSTSB_LENGTH 


eoeecee SS SS SSS SSS SSS SSS SSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSISISOGOGS“SS + 


H DSTSB_TYPE (= DSTSK_SOURCE) ' 


oeceecee Sen sre me ww em wont emenrr eer ere seo mn ene non neoreersananeanonn ana 


A variable number of 
Source File Correlation commands 


} oo cece ccccceccs & 


After the Length and DST type bytes, the record consists of a sequence 
of Source File Correlation commands. These commands specify what source 
files contributed source Lines to this module and how the module's List- 

Line numbers are Lined up with the source files and record numbers 
within those source files. he available commands are described indi- 
vidually below. 


If the Source File Correlation commands needed to fully describe the 
current module will not fit in a single Source Line Correlation DST 
record, they can be spread over any number of such DST records. These 
records will be processed Ht Syrognbe the F in the order that they appear, 
until there are no more such records for the current module. 


The purpose of the Source File Correlation commands is to allow DEBUG 
to construct a table of correlations between Line nusyers and source 
records. A ‘‘line r’’ in th $ context means the Listin ne num- 
ber. This is the Line number which is printed in the program Listin 
is eytous to the PC-Correlation DST records by the cone ler. (PC- 
Correlation DST records correlate Listing Line numbers 4 th Program 
Counter values.) A corresponding source Line is identified by wo 
things: a source file and a record number within that source file. 


The semantics of the Source File Correlation commands can be understood 
in terms of Bentpulet ng three state variables and issuing one command. 
The three state variables are: 


LINE_NUM == The current Listing Line number. 


' 
' 
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i 
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! Define the command codes for all the Source File Correlation commands. 
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SRC_FILE == The File ID of the current source file, 
-e. @ ene) integer uniquely defining 
the source file. 
SRC_REC == The record number (in the RMS sense) in 
the current source file of the current 
source Line. 


NE_NUM is assumed to have an initial value of 1 while SRC_FILE and 
C_REC are initially undefined. The one command is: 


DEFINE(LINE_NUM, SRC_FILE, SRC_REC) 


This command declares that Line number LINE_NUM is aceer tated with the 
source Line at record number SRC_REC in the file specified by SRC_FILE. 


Given this, the coup tor must output a ice of Source File Correla- 
tion commands which cause LINE - SRC_FILE, and SRC_REC to be set up 
appropriately and which cause fhe proper DEF INE operations to be issued 
to allow DEBUG to generate the correct Line number to source record 
correlation table. (DEBUG = not te generate the full table, 
but it must be able to generate any part of such a table it needs.) 

The semantics of each Source File Correlation command is described 
below in terms of these state variables and commands. 


Ll 
SR 


Line numbers must be DEFINEd in sequential order, from lowest Line 
number to highest Line number, in the Source File Correlation commands 
for one module. The source records these Line numbers correlate with 
may be in any order, of course. 


It should be clear from what follows that the source for one module may 
come from many source files. This can be caused 7 plus-lists on the 
compiler command (e.g., SFORTRAN/DEBUG A+B+C) and by INCLUDE statements 
in the source. Also, source Lines may come from modules within source 
libraries as well as from independent source files. 


Form feeds in source files, or more precisely source file records which 
contain nothing but a single form feed (CNTL=L) character, are counted 
as individual sources Lines in some languages but are ignored (not as- 
signed Line numbers) in other Languages. DEBUG wsth handle either con- 
vention, but DEBUG's default behavior is that form feed records are 
ignored in sources files. They are not displayed and they do not count 
toward the source file record number of subsequent source records. To 
—e DEBUG count such records, the DSTSK_SRC_FORMFEED command must be 
used. 


Define the location of the first command in the DST record. 
IELD OSTSSOURCE _F IELDS = 


Peseta SRC FIRST _ CD = C 2, A, ] ! Location of first command in record 


“4 
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Minimum command 9 ® Ay aM ranges 
or s 


Declare a source 


aor ule 


Set the current Mad file (wor 
Set source record number (Longeora) 
Set source record number (wor 

Set Listing Line number (longword) 
Set Listing Line number (wor 


Increment listing Li 


Unused--available 
Unused--available f 
Define N separate 
Define N separate 
Unused=-available 
Unused--avai lable 
Unused=--available 
Unused--available 


ne number (byte) 
for future use 

(fn eee ne 
Lines (word 

. nes (borg) 

or future use 

for future use 

for future use 

for future use 


“4 
@ 


Count Form-Feeds as source records 
Maximum command code for CASE ranges 


4 += -O0----OCO0000C0" 
Hnnnnnnnnnnnnnnnnun 


St a 4 


See ee ee seeeesees ese © & & © & & 
ee ee eee 


AOVEW -OOONOUS Wn 


STSK_SRC_FORMFEED 
a1 SK-SRC"MAX_CMD 


! Define the fields of the Source Line Correlation commands. Also define the 
; corresponding declaration macros. 


FIELD DSTSSRC_COMMAND_FIELDS = 
' 


Field common to all Source File Correlation commands. 
DSTSB_SRC_COMMAND =C0,6_], 
The fields of the Declare Suurce File command. 


! Command code 


DST$B_ SRC_DF_LENGTH ef i, @ iJ. : Length of this command 
DST$B_SRC_DF_FLAGS = - B. J. ! Flag otter areceryee (MBZ) 
DSTSW_SRC_DF_FILEID = ~ wd, i Source file's File ID 
DST$Q"SRC_DF_RMS_CDT = o AL de i Creation date and time or mod- 
i ule insertion date and time 
DSTSL_SRC_DF_RMS_EBK = 13. = i End-of-File block number 
DSTSW_SRC_DF_RMS_FFB =€17, 0.3. | First Free $ Byte in EOF block 
DSTSB_SRC_DF_RMS_RFO = (£19, BJ, | Record and File Organization 
DSTSB_SRC_DF-FILENAME = 0, B- 3, | Source file name counted ASCII 
DSTSA_ SRC_DF-FILENAME = 1. A. de i (count byte, string addr) 
Fields used to access information in all other commands. 
DSTSL_SRC _UNSLONG *{i.t.i. ! Unsigned Lonquerd parameter 
DST$W_SRC_UNSWORD =( 1, Ww i Unsigned word parameter 
ps Tse. SRC_UNSBYTE ={({ 1, i Unsigned byte parameter 


: Declare trailer field in the Declare Source File command. 
FIELD DSTSSRC_DECLFILE_TRLR_FIELDS = 
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| One name counted ASCII 


BMODNAME = f 0, BL }: 
MODNAME = [ 1, A_ (count byte, string addr) 


Declaration macros for Source File Correlation command and trailer blocks. 


TSSRC_COMMAND = BLOCK(, 


TSSRC_CMDTRLR = BLOCKL, 


1 
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DECLARE SOURCE FILE (DSTSK_SRC_DECLFILE) 


This command declares a source file which contributes source lines to 
the current module. It declares the name of tye F ile, its creation 
date and time ~~. yet ious other attributes. he command also assigns 
@ one-word ' file to this source file. inis s the format of the 
Declare ks Fit command: 


to seeecee See ee eee eee eneeneaeanenan Bonamassa tem Boose a enews ese acee ae $ 


DSTSW_SRC_DF_FILEID - The one-word ‘File ID'’ of this source file. This 
File ID, which can Later be used n the Set File command, is 

simply oun unique number which t a compiler assigns _ a se A source 
file vn ch contributes bourse Lines to the current a ust 

source file fous has a nye er (the * le ID) and is pre tied’ - 

that number in the Set File (DSTSK_SRC_SETFILE) command. 


DST$Q_ sre Roe RAS =e - The grestton, date and time of this curse file. 
1s’ qua dword quantity should be retr eyed with a SXABDAT 

pid ed attribute block from ons via the SOPEN or SDISPLAY 

System service. The creation date and time should be taken 

from the XABSQ_CDT field of the XAB. 


If the source file is a module in ’ source Library, this field 
should contain the nodule* s Insertion Date and Time in the Lib- 


byte : DBGS$B_SRC ~ COMMAND (= DSTSK_SRC_DECLFILE) i 
byte ‘ DSTSB_SRC_DF_LENGTH H 
byte H DSTSB_SRC_DF_FLAGS H 
word Hl DSTSW_SRC_DF_FILEID H 
quad : DST$Q_SRC_DF_RMS_CDT ! 
Long H DSTSL_SRC_DF RMS _EBK H 
word H DSTSW_SRC_DF_RMS_FFB H 
byte H DSTSB_SRC_DF_RMS_RFO H 
var |} DSTSB_SRC_DF_F ILENAME H 

ver i DSTSB_SRC_DF _LIBMODNAME | i : 

The fields in this command are the following: : 

DSTSB_SRC_DF_LENGTH = The Length of this command, i.e. the number of 

bytes remaining in the command after this field. : 

DSTSB_SRC_DF_FLAGS - Bit flags. This field is reserved for future use. : 

At present this field Must Be Zero. ; 

i 

i 

i 


+ 
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rary. This value should be re rieved with the LBRSSET_MODULE 

Librarian call. The library file's creation date is not used. 
DSTSL_SRC_DF -RMS BK = The End-of-File block pusber or thi pource 

fTle. This longqword Quantity should & eved with a 


Ww re 
SXABFHC extended attibute block from BS a. oe the SOPEN or 
SDISPLAY system service. The En dcot-Fite. block number should 
be taken from the XABSL_EBK field of the XAB. 


This field should be zero for modules in source Libraries. 


DSTSW_SRC_DF_RMS_FFB - The first $ iree byte of the End-of-File block 
3 is source file. s word quant Me should be retrieved 
with a SXABFHC A... eebe thane lock from RMS via the SOPEN 
or SDISPLAY system service. The first free byte velus should 
be taken from the XABSW_FFB field of the XAB. 


This field should be zero for modules in source Libraries. 


DSTSB_ mm _DF_RMS_RFO = The file organization and record Sorees of this 
Ource file. This byte value eneyié be cotc loves with 
SXABFHC extended attribute block from RMS via the SOpEN® or 
SDISPLAY system service. The file organization and record 
format should be taken from the XABSB_RFO field of the XAB. 


This field should be zero for modules in source libraries. 


DSTS$B_SRC_DF AG ogee - The full filename of the source file. This is 
the Fully epost #iee Fi ry .enepe. complete with device name and 
version number, in which all oh: F cards and logical names have 
been resolved. i 2 Sore should be retrieved with a SNAM 
block from as ¥ ia the SOPEN or S$SEARCH System service, a 
desired a is. poe "Resultant String’’ specified by th 
NAMSL S$, and NAMS$B_RSL fields of the SNAM Slesk 
Here . > Atille aie "i representéd as a Counted ASCII string (a 
one-byte character count followed by the name string). 


DSTSB_ am. =PF LIBMODNAME = The ures aren peepee | name (if applicable) 
the null string. If the source file is octually °. sodule in 
¥ source Library. the DST$B_ SRC _DF -FILENARE 41 field give the 
filename of the source library and the DST$B_SRC_D "LTBRODNAME 
field gives the name of the source module within that torerys 
If the source file Cons not come from a source OB mea, fh 
field (DST$B_SRC_DF - IBMODNAME) contains the null (zero-l ength) 
string. This fiéldis represented as a Counted ASCII string. 


4 
w 
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I DD De i ee i De he ted ed ed oe a eh th te Lhe te te te ee 


byte 
word 


byte 
Long 


SET SOURCE FILE (DSTSK_SRC_SETFILE) 


This command sets yee cyrrent soures file to + file denoted by the 
qnesvere file 1D given in the command. The set file is then fhe file 
from which further source lines are taken chen the sorroagens ng list- 
ing Lines are defined. This is the format of the command 


Pesos een seme er ewe mee anen ne eeeceoe i ee 


' DBGSB_SRC_COMMAND (= DSTSK_SRC_SETFILE) ' 


Geweeeecescecececes eeeeoe See eee e2eeeeeeeeeeneaeae sean aera ese => eeenreceroee +} 


H DSTSW _SRC_UNSWORD: The File” ID of the desired source file ; 


The semantics of this command is: 
SRC_FILE := file ID from command 


SRC_REC := set to current source record for this 
source file 


SET SOURCE RECORD NUMBER LONG (DSTSK_SRC_SETREC_L) 


This command sets the current source file record number to the longword 
value specified in the command. Its format is: 


Freee eer eee ee eee eee ee esse eeee eee eee eeeeeeeeeeeeeeeseesesescecsecsca + 
DBG$B_SRC ~ COMMAND (= DSTSK_ SRC “SETREC al? H 
BAL DSTSL_ SRC -UNSLONG: The desired new source record number H 
The semantics of this command is: 

SRC_REC := Longword value from command 


FI 


=" 
ow 


m1 
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SET SOURCE RECORD NUMBER WORD (DSTSK_SRC_SETREC_wW) 


This command set the current source file record number to the word 
value specified in the command. It is thus a more compact form of 
the DSTSK_SRC_SETREC_L command. Its Be. is: 


$¢erewme ecw nem ee ew ee eee ecm oeem enero eco wecens eeeeeon Sw TTB ORB ee ee eee See eS} 


byte i DBG$B_SRC_COMMAND (= DSTSK_SRC_SETREC_w) H 


oeeeoe ee Y 


word ‘ DST$W_ SRC_UNSWORD: The desired new source record number H 


ane me ee mm me we we me es oe oe OS OOS SSS S SSS O SSS SSSSSSSSSSSSSSSCSSSSSCSSSseeeeeeeo4 
The semantics of this command is: 
SRC_REC := word value from command 
SET LINE NUMBER LONG (DSTS$K_SRC_SETLNUM_L) 


This command set the current Listing Line number to a longword value 
specified in the command. Its format is: 


ee a eee eseeee See eee eeeeeoeneo Seeeeeeeeeeaeneaeo een eos $ 


byte H DBGSB_ SRC - COMMAND (= DSTSK_SRC -SETLNUM_ L) i 
long : DSTSL. SRC “UNSLONG: “The desired Listing Line number ! 


The semantics of this command is: 


LINE_NUM := longword value in commmand 


N 
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le ee ee ee ee et ee 


byte 
word 


byte 
byte 


SET LINE NUMBER WORD (DSTSK_SRC_SETLNUM_W) 


This command sets the current Bab Line number to a one-word value 
specified in the command. Its format is: 


fescoceer nee room on eres emo mene ee eee eee Oem Ee ET eee CBOE Bees ewer ewan e} 


' DBGS$B_SRC_COMMAND (= DSTSK_SRC_SETLNUM_W) 


Goewsewseveesccensoues ae Gownaneuennwensseuseeeeoeaseueuenasse coed 


H DSTSW_SRC_UNSWORD: The desired Listing Line number H 


Seeeeeeooeeee Sasesbuaeeueceuees eseeeeaeoeee SK OO B HE RODE ROME eM ae a eh 


The semantics of this command is: 
LINE_NUM := word value in command 


INCREMENT LINE NUMBER BYTE (DSTSK_SRC_INCRLNUM_B) 


This command increments the current Listing Line number by a one-byte 
value specified in the command. Its format is: 


¢ eee ree wen en een nnee See Bese tO Se OT ere essen eens see emecesuee eneet 


i DBGSB_ SRC _ COMMAND (= DSTSK_ SRC_ INCRLNUM 8). i 


The semantics of this command is: 
LINE_NUM := LINE_NUM + byte value in command 


— 
m 


' 
. 
' 
. 
' 
. 
‘ 
. 
' 
. 
' 
. 
' 
. 
' 
* 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
* 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
. 
' 
° 
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byte 
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COUNT FORM-FEEDS AS SOURCE RECORDS (DSTSK_SRC_FORMFEED) 


This command spe hy that DEBUG should count source ,Feceres which 
consists of nothing but a Form-Feed gnerecter (CNTL=L) as being 
distinct, numbered source records — languages, such records 
are not considered to be source Lines; nstead they are regarded as 
control information. The compiler then does not assign Line numbers 
to them and DEBUG ignores them ayy te iy ae : not displayed 

as part of the source and they do not contr o the source record 
numbering of source files. However, if the DS TS. “eRe St Hy: gepnens 
is specified in the Source File Correlation DST Record for a module, 
then such records count as normal records; they can be displayed and 
they are assigned source file record numbers. 


If used, this command must appear before any commands that actually 
define source lines. Making it the first command in the first 
Source File Correlation Record for the module is a good chatea. 


The semantics of this command is to set a mode flag which says to 
count Form-Feed records as normal records. The default behavior 
is to ignore Form-Feed records. 


Zo 


nn 
on 
m 
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byte 
word 


byte 
byte 


DEFINE N LINES WORD (DSTSK_SRC_DEFLINES_w) 


This command defines the source file and source record numbers fur 
a specified number of Listing Line numbers. The specified number is 
given by a one-word count in the command. The command format is: 


tomoee eee eeeeeseooen Seeeeeeoeee Se weeeeeeeeeee sees ee soesseeeessess} 
~_DBGSB_ SRC — COMMAND (= DSTSK_SRC -DEFLINES_ aw) H 
H DSTSW SRC _UNSWORD : The number of Lines to “define 


dome m een sees SOGSSDensenessdecseeeeeounsssesnuasesesesecaesuseoos + 


+-- 


The semantics of this command is: 
DO the weer of times specified in the command: 
4 a ee NUM, SRC_FILE, SRC_REC); 
LI ="LINE_NUM™+ 1; 
Ace Rec = SRC REC + 1; 


DEFINE N LINES BYTE (DSTSK_SRC_DEFLINES_B) 


This command defines the source file and source record number for 

8 oy beagle eee a - oie Line numbers. The specified number is 
iven by a oyte in the command. This is thus a more compact 

orm of the STs “§re oDEFLINES _W command. Its format is: 


o} 
@ 
tt 
‘vn 
Bs) 
ft 
4 
.— | 
- 
" 
4 
wn 
“ 
bd 
c"s 
lat 
2 
os 
t's 
iS 
nm 
ie 
— 
z 
m 
‘op 
~" 


err mere tee eee eee eww ecm wm mmm mmm em emo eee ew em mm mmm meme meme ee wee ero e eee oe ee 


The semantics of this command is: 


DO the mer of times specified in the command: 
DEF INE (LINE NUM, SRC ore SRC_REC); 
LINE SNUM ="LINE_N 
ae C REC := SRC NRECU® 


i END OF SOURCE FILE CORRELATION DST RECORD DESCRIPTION. 


D1 
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THE DEFINITION LINE NUMBER 
DST RECORD 


NOTE: THIS DST RECORD IS NOT SUPPORTED BY DEBUG V4.0. 


The Definition Line Number DST record agec figs the Listing Line 
at which a data symbol or other object | is defined or declared. 


ser can see the declaration source Line for t y Ret fied 
ay. recere of the data object whose Line of definit 


This is the format of the Definition Line Number DST record: 


number 
he 


se ae is to make use of this information in future DEBUG commands so 


symbol. 


the BP oe Ph Line Number DST record must meq totaly jo\ Loy the ot 
on is being speci- 


ated ES wenenenn PSTSBILENGT (56) naan ; 

| ee semnennaDSTSBLTYPE = (OSTSK_DEFLUNUND 0 a 
etn FEC A, nanan Mactan Bie ook 3 A IL MOOR 
long | ~_DSTSL_DEF_LNUM_LINE 


in the DST record is reserved for future use. 
IELD DSTSOEF _LMUM_FIELDS = 
OSTSL_DEF LNUM_LINE =€ 3, L. ] ! The definition Line number 


i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
F 


Define the fields of the Definition Line Number DST record. The unused byte 
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THE STATIC LINK DST RECORD 


The Static Link DST record specifies the ‘Static Link'’' for a routine. 
The Static Link is a pointer to | VAX call frame for the proper up- 
scope invocation of the outer routine within which the present invoca- 
tion of the present routine is nested. The Static Link is thus used 
when DEBUG does up-level addressing in response to user commands. A 
Static Link DST Record : always aseoc tated with the inner-most routine 
within whose Routine-Begin ond Routine-End records it is nested. The 
Static Link DST Record is optio ysee by Languages 
or for routines which do not keep srosk of static Links in their run- 
time environments. In fact, the Static Link DST record only makes a 
difference for recursive routines that pass routines as parameters, a 
fairly obscure situation. 


This is the format of the Static Link DST record: 


nal--it need not be 


cs 
=< 
o 
e 
i=] 
un“ 
z 
‘ 
— 
~< 
vu 
mm 
~~ 
tu 
4 
“ 
—5 
of 
x 
4 
wt 
“4 
> 
— 
- 
— 
2 
x 
~ 


var 
A DST Value Specification Giving the Value of the 
Static Link, i.e. the FP Value of the Routine Invocation 
Statically Up-Scope from this Scope 


} oo mewn cence cccccccs 


Define the fields of the Static Link DST record. 
IELD OSTOSTATLINK_FIELDS = 


DSTSA_SL_VALSPEC =(€2, A, ] ! Location of Value Spec giving 
Tes : the up-scope FP value 


' 
i 
i 
i 
i 
i 
i 
i 
i 
' 
i byte ! DST$B_LENGTH 
! 
i 
i 
i 
i 
i 
i 
i 
i 
i 
F 
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THE PROLOG DST RECORD 


The Prolog DST record tells DEBUG where to put routine breakpoints. 
It is used for routines that have prolog code that must be executed 
before data objects can be freely examined or otherwise accessed 
from DEBUG. Such prolog code Syerees hy sets up stack locations and 
descriptors for formal parameters or other data objects. By putting 
routine orege oints on the first instruction after the proton code 
as specified in the oe DST record, DEBUG ensures that al local 
€ 


storage and formal parameters are ac essible to the user. 


tracepoints requested by the user. If specified, the Prolo 
record is counted as belo R 
Point DST record before i 


This is the format of the Prolog DST record: 
Gomme rm en wean wee wee SSS SSS SSS SSS SSS SSSSSSSSSTSSSSBSSSSSSTSSSSSSSOSESEeS + 
byte ; DSTSB_LENGTH (=5) ' 
+ 
byte } DSTSB_TYPE (= DSTSK_PROLOG) ' 


wee eee ee ee ee eee See eee cee eee eee Bee RE BEN SOO SRM Ow OB wBese EO Bee reese} 


long } DSTS$L_PROLOG_BKPT_ADDR 


domme wro nner re enn ee ww ere meee emer mwr nmr me nm warmer ere nr ere meno aoe + 


Define the fields of the Prolog DST record. 
IELD DSTSPROLOG_FIELDS = 
Perot POOLS SEPT _AOOR st 2.4. 3 ! The routine breakpoint address 


' 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
! 
: Point DST record with which it is associated is good practice. 
' 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
F 
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' 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
F 


byte 
byte 
byte 
byte 


THE VERSION NUMBER DST RECORD 


The Version Number DST record gives the version number of the compiler 
that compiled the current module. The Version Number DST Record must 
be nested within the Module Begin and Module End DST Records for the 
module in question. oceuy ignores this record except in special cases 
when it is necessary to distinguish between old and new versions of the 
compiler that generated a given object module. 


This is the format of the Version Number DST record: 


' DSTSB_LENGTH (= 3) 


beeen ee sececee SSS SS SSS SSS S222 22S S22 S222 2264~ OMe Ti cease oer en mee oma + 


DSTSB_TYPE (= DSTS$K_VERSION) } 


tremor ace cao et eecm meee eeeooeoeoe S28 S SSS SSSSSSSVBSVSSSSBSlS’s SSSSHSSQeeeeoeenoneoe + 


i DST$B_VERSION_MAJOR i 


boone tence SSS SSS SSS SSS SSSSSSSSSSSSSSSSSSSSTSSESEGe2eeee eee tee wee + 


' DST$B_VERSION_MINOR ' 


¢eeeececeon wee ee eee ea eer ew eee sete fem Se ee ee oe Serta tet ee eet one ne meee + 


Define the fields of the Version Number DST record. 
IELD OST PYERS ION FIELDS = 


DST$B_VERSION_MAJOR = f ¢ B_ : ! The major version number 
th aac inane = , % ! The minor version number 


“4 
@ 


¢ 
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byte 
byte 


THE COBOL GLOBAL ATTRIBUTE 
DST RECORD 


The COBOL Global Attribute DST record indicates that the symbol whose 
DST record samegietely follows has the COBOL ‘‘global"’ attribute. This 
attribute specifies that the symbol is visivle in nested COBOL scopes 
(routines) within the scope (routine) in which the symbol is declared. 
Without this attribute, a symbol is only visible in its scope of decla- 
ration but not within any nested scopes. In this regard, COBOL differs 
from most other languages. DEBUG thus needs to know this attribute in 
order to implement the COBOL scope rules correctly. 


The COBOL Global Attribute DST record is only generated by the COBOL 
compiler. If it precedes the DST reser? for some symbol, that symbol 
is deemed to have the COBOL global attribute; if it omitted, the sym- 
bol is deemed not to have the global attribute. DEBUG ignores this 
attribute for all other Languages. 


This is the format of the COBOL Global Attribute DST record: 


¢eweeresee CORE Cone enero nme eee emo e aon e oe e ow owen eee enna sen ae + 


' DSTSB_LENGTH (= 1) \ 


oem enawee seeeeeoe See eeeeeeeeecenee Se ee eeeeeeoeoneaeneeo naa wane owroere2e2oecoe = = 


' DSTSB_TYPE (= DSTS$K_COBOLGBL) ' 


Poem owe moo ae eeeeeoeeeoeoeoeoeoeeen SB On ew oan es Sw eae teen eee we we = A ee en + 


_" 
@ 
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THE OVERLOADED SYMBOL DST RECORD 


NOTE: THIS DST RECORD IS NOT SUPPORTED BY DEBUG V4.0. 


The Sper ontye Symbol DST record is > 9 indicate that a given 
symbol name is overloaded. The record indicates which other symbols 
in the DST are ppse tote resolutions to the overlcading. It is used 
by the ADA compiler. 


n ADA, it is possible to have more than one routine ef the same name 
n the same scope. If the routine name is R, DEBUG disambiguates the 
individual me gf the overloaded routine name with the invented 
names R__1, R_ R__5, and sc on. DEBUG requires the ADA compiler to 
generate normal bsT records for these routines, using the invente 
names. DEBUG also requires the ADA compiler to generate the Overloaded 
Symbol DST record with the original overloaded name ‘'R'’ in order to 
inform DEBUG of the overloading. 


After the Length and type fields, this record contains a Counted ASCII 
string with the name of the overloaded symbol. res ayes the Counted 
ASCII string, there is a word field Genta ining a@ count of the number 

of overloaded instances of the name in this scope. Next there is a 
vector of pointers, one for each instance, pointing to the DST records 
for the instances of the overloaded symbol. These DST pointers consist 
of byte offsets relative to the start of the whole DST. 


This is the format of the Overloaded Symbol DST record: 


Per ses secures m aces BROMO eerarnae@e anwar ee woo nrwmee ana wran ere eweaneees + 


of the Symbols with Invented Names that Constitute 
the Instances of this Overloading 


Sete TL abetiiiiie aisle 2 a naa RECT Secor Carl } 
ea ET a Dh ten ae ee bY ; 
Otc onasebuenmnans eidesemamence etl ocnubaiesebecmanammamaions ; 
00 The Overloaded Symbol Name in ASCII ! 
: (The name's Length is given by DST$B_OL_NAME) | 
| cnduendiivecinianiiptnhicanebensineninaentcnaannien ee 
Oe 21 cuibssapeenanebieee te tee tilaaimmanenaieiadiiene ; 
ver} DSTSA_OL_VECTOR 
A Vector of Longword Pointers to the DST Records 


1 
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geese s eeeecoeeceoe See eee eneaneo wrevecaan an aecaesn er enrscesae sae eed 


! 
' 
' 
1 
Define the fields of the Overloaded Symbol DST record. 
FIELD DSTSOVERLOAD_FIELDS = 


DSTSB_OL_NAME =([ 2, 8B. ], ! Count byte of the overloaded symbol 

} e Counted ASCII Sring 
DSTSA_OL_TRAILER= C 3, A_ ] ! The trailer fields start at this 
res : Location + .DSTSB_OL_NA 


! Define the fields of the Overloaded Symbol DST record trailer portion. Also 
define the corresponding declaration macro. 


FIELD OSTIPVERLOND.. TRLR_FIELDS = 


os T$w -OL_COUNT = F 0, WL }° ! Number of instances in this scope 
DSTSA_OL_VECTOR = ( 2, A ; Vector of DST pointers to instances 
—_ : of overloaded symbol 


MACRO 
DSTSOVERLOAD_TRLR = BLOCKC,BYTE] FIELD(DSTSOVERLOAD_TRLR_FIELDS) %; 


!' This is a short BLISS example of how the trailer fields are accessed: 


LOCAL 
DSTPTR: REF DSTSRECORD, 
OVERLOAD_COUNT 
OVERLOAD TRAILER: 

F Bs STSOVERLOAD_ TRLR, 


t 

i 

! 

! 

Pointer to DST record 
! 

i 

: OVERLOAD VECTOR: 
i 

' 

' 

! 

4 

{ 

! 


The number of overloadings 
Pointer to DST record trailer 


Vector of DST-record pointers to the 
instances of this overloading 


REF VECTORC,LONG); 


Here we assume that DSTPTR points to the Overloaded Symbol DST record. 


OVERLOAD_ TRATLER = DSTPTRCDSTSA_OL betes OL Cc + ,DSTPTRCDST$B_OL_NAME); 
OVERLOAD-COUNT = .OVERLOAD ~TRAICEREDST OUNT); 
OVERLOAD “VECTOR = OVERLOAD_TRAILERCDSTS$A_OL ~VECTORA; 


~~ 
ow 


+ 


byte 
byte 


— 
& 
> 
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CONTINUATION DST RECORDS 


When the text of a Debug Symbol Table focere is longer than 255 bytes, 
it is no longer possible to hold that text in a single Be! record since 
the DSTSB_LENGTH field cannot hold a value larger than 255. In this 
case it iS necessary to generate the original DST record followed by 

as aeny Fons inuet ton DST records as aapeeeere ” hold the ig text. 

The or ef nal DST record then holds at least 100 and at most 255 bytes of 
text. ach Continuation DST record consists of the standard two-byte 
header followed by the continued text of the original DST record. 


This is the format of the Continuation DST record: 


H DSTSB_LENGTH H 
‘ DSTSB_TYPE (= DSTSK_CONTIN) H 
The Continued Text of the Previous DST Record 
e ewe e es eee e nme = oS ee Se Ree SB RS Se Se Sm we we eo em oe ee oe (= ce ae wt ae ee on o> em ce oe Ss ee eee > 


DEBUG reconstitutes a continued DST record by Conegtongt ing the text 

of the first DST record with the text portions of its Continuation DST 
records. In effect, the first two bytes of each Continuation DST record 
are stripped out. Any further interpretation of the DST text is then 
done on the concatenated copy. 


Certain kinds of DST records are not allowed to be continued with Con- 
tinuation DST records. These records are Module Begin, Routine Begin, 
Block Begin, Label, Label-or-Literal, Entry Point, SECT, Line Number 
PC-Corre ation, and Source File Correlation DST records. In addition, 
DST records with fixed sizes, such 9s Module End and Routine End DST 
records, are not allowed to be continued. Line Number PC-Correlation 
and Source File Correlation DST records cannot be continued with Con- 
tinuation DST records, but one can have multiple such records in one 
module; they can thus be continued, but through a different mechanism. 
The records that really nged to be continued, such as Standard Data 
DST records and their variants (Descriptor Format and Trailing Value 
Specification Format records), Separate Type Specification DST records, 
and Type Specification DST records, can all be continued using the 
Continuation DST record mechanism. 


Define the fields of the Continuation DST record. 


= 
om 


oa 


i eh ee ee ee re ee ee ee ee ee ee 


=a 
> 
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—s 
m 


+ 


FIELD OSTSCONTIN_FIELOS = 
Pe rSA.conT iN = €2, A,] ! Address of continuation text 


mM 
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OBSOLETE DST RECORDS 


There are several obsolete DST records. These are records that were 

at one time generated by compilers, but are no longer used by any cur- 
rent version of any Digital compiler. Some of these records were not 
properly thought out and were abandoned when it was realized that their 
ntended uses could not be implemented. Others were at one time used 
and useful, but were generated by now-obsolete compilers. Such records 
are not generated by current compiler versions, and the capabilities 
coay Grencees ar2 now provided more general mechanisms in other DST 


None of the obsolete DST records should be poneretes by any future 
compilers, and their use will not necessarily be supported by DEBUG. 


THE GLOBAL-IS-NEXT DST RECORD 


The Global-is-Next DST record is now obsolete. It consisted of just the 
DSTSB_LENGTH byte and the DSTSB_TYPE byte. DSTSK_GLOBNXT was the type 
code. The purpose of this record was never properly thought out and 

no support for it was ever implemented. It should not be generated by 
any future compilers or compiler versions. 


THE EXTERNAL=IS-NEXT DST RECORD 


The External-is-Next DST record is now obsolete. It consisted of just 
the DSTSB_LENGTH byte and the DSTSB_TYPE byte. DSTSK_EXTRNXT was the 
type code. The purpose of this record was never properly thought out 
and no support for it was ever implemented. It should not be generated 
by any future compilers or compiler versions. 


THE THREADED-CODE PC-CORRELATION DST RECORD 


This DST record is identical in format to the Line Number PC-Correlation 
DST record except that the record type code is DSTSK_LINE_NUM_REL_R11. 
It was used an obsolete COBOL compiler according fo legend (the memo- 
ries are a » nazy by now). The idea was that the threaded code gene- 
rated by this gonp ler consisted of a vec tor of longwords where each 
Longuord contained the address of ? run-time support routine to call. 
Register R11 pointed to the beginning of this vector. The code gene- 
rated for a source line thus consisted of some number of longwords 

with addresses to call (or perhaps jump to--the exact details are lost 
in the mists of time). The line number PC-correlation information 
passed to DEBUG consisted of Line numbers correlated with byte-offsets 
relative to R11 (i.e., to the start of the threaded code). Breakpoints 


N 
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were placed on a specified line by looking up the correspgnd ing offset 
relative to R11 and then storing an address within DEBUG into that 
location. When the hocat on was reached, DEBUG was entered. 

could then convert the ‘PC"’, i.e. the threaded-code location, back to 
a line number to announce the aroakap int. It is not clear how, or even 
whether, tracing, stepping, and watchpoints were implemented. 

The Threaded-Code PC-Correlation DST record is no longer supported by 
DEBUG and should not be generated by any current or future compilers. 


THE COBOL HACK DST RECORD 


The COBOL Hack DST record was at one time used to support formal argu- 
ments to COBOL procedures. It has now been superceded by the more 
general Value Specification mechanism, and is thus obsolete. It is 
no sanger generated by the COBOL com filer, and it should not be gene- 
rated by any current or future compilers. Future versions of DEBUG 
may not support it. 


The fields of this record consist of the fields of the Standard Data 
DST record followed by a type field that specifies the data type and 
then a sequence of commands for the DEBUG stack machine. (See the sec- 
tion on Value Specifications for details on the DEBUG stack machine.) 
The Ba pee: of interpreting the stack machine routine is the address of 
the object described by this record. The DST$B_VFLAGS and DSTS$L_VALUE 
fields are zero unless the object has a descriptor. In this latter 
case they specify the Location of the descriptor. The result of the 
stack machine routine is placed in the DSCSA_POINTER field of the 
descriptor before it is used. In addition, if it is an array descrip- 
tor, the DSC$A_AO field is added to the result of the stack machine 
routine and the result is placed in the DSCS$A_AO field before the 
descriptor is used. 


The type field following the name field contains the VAX Standard Type 
Code of the object being described here. If the object also has a 
descriptor, its DSCSB_DIYPE field must agree with this code. 


The stack machine commands used in this context are those described 
in the section entitled ‘The DEBUG Stack Machine’ in the chapter on 
DST Value Specifications. 


This is the format of the COBOL Hack DST record: 


TBKDST.REQ;1 


byte 
byte 
byte 
Long 
byte 
var 


byte 
var 


Define the fields of the Cobol Hack DST record. 
macro for the trailer fields. 


homeo maes (ee ee ee we we SSeS See eee eeana @Seeeeceanoaaeaeao (Sm > om at oe + 
' DSTSB_LENGTH \ 
bomen ae (Se gS SD Se ee ee eS ee me aueesoecusecee See an oe ee oo wee ener eae mamma we + 


\ DSTSB_ TYPE (=DSTSK_COB_HACK) \ 


bem owe amas eeoeeseweseeesoeesoeenweeescooseseeoasseceesseooececcs + 


H DSTSB_VFLAGS ' 


beernn--e - eeeeceecen eeececeen Soe e same Seaeuasnnewtenenaecasae cane e me woe $ 
! DSTSL VALUE t 
' DSTSB NAME ' 
+ om ee ee ee eeeeeee ee eeeaaeaceae Be ewe Ber were = eeececeea Cee eRe mene oe em ee} 
The Name of the Data Symbol in ASCII 
(The name's Length is given by DSTSB_NAME) 
Spncnnesenenetibeienienmnntinenminiiomaieamneincrntaienseiptatiiatstgasiitiainmnnnibiennarians Te + 
~ DSTSB. CH. TYPE ' 
-sece eww eee wenn newness ewe ome se eee saeeeence weer eres er ree e me eceraonmaaa + 
' DSTSA_CH_STKRTN_ADDR 
Instruction Sequence for the DEBUG Stack Machine | 
H eer wre rer ero eer ec ewer ence See eee ee e2eeeeee eee eee teem nee wr ren eee + 


FIELD DSTSCOB_HACK FIELDS = 


DSTSA_COBHACK_TRLR 
TES; 


FIELD BsTeen.. TRLR_FIELDS = 


MACRO 


DST$B_CH 


uu 
ew 


TYPE BL - ! VAX standard data typ 
PereA. CH_STKRTN_ADDR A 


DSTSCH_TRLR = BLOCKC,BYTE) FIELD(DSTSCH_TRLR_FIELDS) 2%; 


Also define the declaration 


C 8, AL J ! Location of trailer fields 


. = ! Start of stack routine code 


14 
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' 
i 
' 
! 
F 


TBKDST.REQ;1 


var 
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VALUE SPECIFICATION DST RECORDS 


The Value Specification DST record contains nothing but a DST Value 
spec St ication. However, there appears to be no use for this record 
since all DST Value spqc 'Ticet ions that are actually used appear in 
other DST records. This record was probably designed with some use 
in mind, but was then abandoned when better ways of addressing the 
original need were gethe a DEBUG ignores this DST record, and it 
is believed that no compilers actually generate it. This 6ST record 
should not be generated by any future compilers. 


This is the format of the Value Specification DST record: 


Tete eee Oe SPOS SSeS eH SSS Se SSS eees esse esses eeceeesesessoes} 


+ - 
; DSTSB_LENGTH 


boescene See eeeee eee eee eeeee ee eeeseeeceeee See moe Se eM a eo + 


DSTSB_TYPE (= DSTSK_VALSPEC) 


+-- 


+ 
A DST Value Specification 
+ 


} occcccess 


Define the fields of the Value Specification DST record. 


IELD DSTSVALSPEC_FIELDS = 


DSTSA_VS_VALSPEC_ADDR = C 2, A_ ] ! The start location of the 
TES : Value Specification 


) 
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DST RECORD DECLARATION MACRO 


This macro allows BLISS symbols which are qc hares DSTSRECORD or 
REF DSTSRECORD to be qualified by all the f #8 names present in 
the various DST record formats It is anticipated that users will 
declare separate symbols for tield sets which describe tra Ling 
fields in DST records; a pointer to the PSECT DST record trailer, 
for example, would be declared to be a REF DSTSPSECT_TRAILER. 
Separate macros are supplied above for all such trailer fields. 


Define the declaration macro for all DST records. 


ACRO 
eer = BLOCK pg78 B1TE2 FIELD( 


ST 
STSOSC_FI 
ST$T 


$ 
$ 

a 
$TYPSP 
$ C_ 
$CH_TRLR 
SOVERLOA 


! END OF DSTRECRDS.REQ. 


4 
ow 
= 


ca 
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